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system to the installations needs; Part IV 
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for the duration of a star tup- to- shutdown 
session. The appendixes contain examples 
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generation macro instructions. 
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PREFACE 



This publication explains how to speci- 
fy, create, maintain, and modify an 
installation-adapted IBM Time Sharing Sys- 
tem, This book is intended for system pro- 
grammers who perform system generation and 
maintenance. 



This publication assumes a general 
knowledge of TSS from IEM Time Sharing Sys- 
tem; Concepts and Facilities , GC28-2003. 



SUGGESTED READING 



Part I, the Introduction, presents the 
procedures to be followed for generation 
and maintenance of IBM Time Sharing System 
(TSS), The reader is guided to later sec- 
tions by indications of what is accomp- 
lished at each step in the procedures. 

Part II describes the use of the initial 
release of TSS to create a basic time- 
sharing system under which an individual 
installation's system can be generated. 

Part III describes the system generation 
method of assembling macro instructions 
that specify an installation's machine con- 
figuration and system parameters, together 
with the methods of applying them to the 
system. 

Part IV explains how the system- 
maintenance process modifies the installa- 
tion's TSS with IBM-supplied changes. 

Part V presents a method of dynamically 
modifying TSS during startup, to test the 
effects of system modifications before they 
are permanently inserted into the system. 

The appendixes contain examples of sys- 
tem generation, maintenance, and dynamic 
modification based on a sample time- sharing 
machine configuration. Also, tie appen- 
dixes include reference material on device 
addressing, the system libraries, and 
examples of system-generation macro 
instructions . 

PREREQUISITE READING 



The command system for TSS users is de- 
scribed in IBM Time Sharing System: Com- 
mand System User's Guide , GC28-2001. 

The command system facilities for mana- 
gers and administrators are in IBM Time 
Sharing System: Manager's and Administra- 
tor's Guide , GC28-2024. 

The programs for direct access storage 
device initialization and dump/restore are 
discussed in IBM Time Sharing System: In- 
dependent Utilities , GC28-2038. 

For operators, information on the 
startup procedure and the command system 
facilities is in I& Time Sharing System: 



Operator's Guide , GC28-2033. 

A list of all messages issued during the 
system generation and maintenance pro- 
cesses, and directions for actions to be 
taken, are in IBM Time Sharing System: 
System Messages , GC28-2037. 

Definitions of all TSS macro instruc- 
tions, except those for system generation, 
are in either IBM Time Sharing System: 
Assembler User Macro Instructions , GC28- 
2004 or in IBM Time Sharing System: System 
Programmer's Guide , GC28-2008. 

The TSS assembler language is in IBM 
Time Sharing System: Assembler Language , 
GC28-2000. 

The TSS linkage editor is described in 
IBM Time Sharing System: Linkage Editor , 
GC28-2005. 
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PART I: INTRODUCTION 



The IBM Tirre Sharing System CTSS) is adapted specifically tc a user's 
installation by the system generation process that defines the installa- 
tion's hardware configuration, its task-management parameters, and its 
command-system options. T£S may be modified by the system maintenance 
process, which applies IEF-supplied maintenance packages tc the system 
data sets, or TSS may be modified by the dynamic modification process 
for the duration of one startup-to- shut down session. 

BASIC S YSTEM 

An operable version of TSS is needed tc run the system generation 
process. Tc construct a basic system, IBF supplies each installation 
with nagnetic tapes that contain such a version. 

Csing disk initialization and tape-to-disk dump/restore utility pro- 
grams (See Figure 1), the IBM-supplied restcre tape fcr the initial pub- 
lic volune is written onto a disk. Then, one additional system disk and 
any drum that will be used for paging are initialized. 

The basic system contains three pre- joined users; the system opera- 
tor, the system manager, and the system prcgrarrmer. At the completion 
of disk and drum initialization, and the public volume restore, the op- 
erator can start the Time Sharing System, as described in the Operato r * s 
Guide. 
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Figure 1. Time Sharing System Generation Procedures 
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An installation-adapted TSS is created by using the system aeneration 
procedure: the specification (via SYSGEN macro instructions) of data 
for system tables that contain configuration-dependent information and 
some installation parameters; the assembly of these macro instructions 
into control sections containing system tables; and the application of 
these systen control sections to the operational TSS . 
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Introduction 



Using the basic system , the pre joined system programmer (who has 
access to all system data sets) logs on at a terminal (other than the 
operator's) and assembles the system generation iracro instructions (de- 
scribed in Part III). When the assembly is terminated, he ascertains 
that he has an error-free assembly that accurately reflects the instal- 
lation^ parameters and configuration-dependent tables. 

Using the object module produced by his assembly, the system pro- 
grammer executes the APGEN procedure (described in Part III). This pro- 
cedure modifies the system by replacing certain system modules with the 
content of the SYSGEN assembly object module. This procedure completes 
the modification of the system. Subsequent system startups will now 
reflect the installation specified SYSGEN data. 

After an installation has teen operating under TSS for some time, 
some of the installation's parameters may need to be changed. Another 
system generation will be required to make the changes. The procedure, 
shown in the bottom side of Figure 1, is a subset of the original SYSGEN 
procedure. Since an operable TSS exists, the system programmer (userid 
TSS) can log on immediately, assemble the system generation macro in- 
structions, and execute the APGEN procedure. After this process has 
been completed, TSS must be shut down; then, using the newly updated 
TSSBES voluire, the system operator must restart TSS. 

SYSTEM MAINTENANCE 

The TSS linkage editor and command system are used to modify system 
data sets according to the IBM-supplied maintenance packages? installa- 
tions that have not made their own changes and are using a standard sys- 
tem can maintain their systems by using the IBM-supplied maintenance 
packages (change tape and change script). 

However, installations that have made their own changes to the stand- 
ard system can modify the change script. This type of system alteration 
should be attempted only by a system programmer who is thoroughly fami- 
liar with the interfaces among the system components. 

The change scripts (command procedures contained in data sets) are 
then run to apply the maintenance changes. When the system maintenance 
run has been completed, the modified version of the system is made a- 
vailable by shutting down TSS and restarting the new version of the sys- 
tem from the I PL volume. This procedure is shown in Figure 2. 
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Figure 2. Time Sharing System Maintenance Procedures 



DYNAMIC MODIFICATION 

T3S is designed so that the contents of initial virtual storage and 
resident supervisor can be dynamically modified during startup- Changes 
to the initial virtual storage, the resident supervisor, and the resi- 
dent support system routines can be tested without permanently updating 
the system. All changes must be placed in delta data set form on one 
VAM volume. Changes made by dynamically modifying the system remain in 
effect until a SHUTDOWN command is issued. 

The procedures to be followed and the specifications to be made dur- 
ing startup are detailed in Part V. 
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PART II: BUILDING THE BASIC SYSTEM 



SECTION 1; INITIAL RELEASE PACKAGE 

The initial release package contains the material necessary to build 
a basic TSS under which the system can be generated (SYSGEN). Two nine- 
track tapes contain the utility programs and data sets that constitute 
the Time Sharing System. Two 3330 Model 1 volumes (or larger) are 
needed to start up the basic TSS. 

The TSSRES (public volume zero) restore tape contains the data sets 
needed for system residence. A detailed description of all system data 
sets is given in Appendix B. Four of these data sets (RESSUP, SYSIVM, 
RS3SUP, and SYSCCB) contain tables that describe the minimum machine 
configuration. These tables were generated by the SYSGEN described in 
Appendix D. 

Volume Preparation 

The steps required for the initial system generation are shown in 
Figure 3. Before building the system, two 3330 Model 1 (or larger) di- 
rect access volumes and a 2305 Drum (if any) must be VAM formatted by 
the Direct Access Storage Device Initialization Program (DASDI). This 
stand-alone utility program is described in Independent Utilities . One 
of the disk volumes is initialized as a public VAM volume and the other 
disk as a paging volume. When the disks have been initialized r the Di- 
rect Access storage Device Dump/Restore (DASDDR) Program (see Independ- 
ent Utilities ) can be loaded from the utility tape. Using suitable con- 
trol cards the TSSRES restore tape can be written onto the newly initia- 
lized public volume. This disk becomes the first public volume (rela- 
tive public volume zero) of the basic system. 

When the volumes have been readied, the operator sets the selector 
switches for the TSSRES volume and presses the LOAD key. This proce- 
dure, called IPL (initial program loading), reads in Prelude (a loader 
for the Independent Access Method, IAM. The operator requests that a 
TSS long start be performed. IAM then locates, reads, and passes con- 
trol to the STARTUP module. 
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Figure 3. Initial. System Generation 



SECTION 2: STARTUP 

Startup, the module that performs the operations necessary for 
initializing TSS, has three primary functions: 

1. Link- load the CSECTs in the initial virtual storage (from the SYS- 
IVfo data set), in the resident supervisor (from the RESSUP data 
set), and in the resident support system (from the RSSSUP data 

set); 

2. Create or initialize various tables; 

3. Create the main- operator task and pass control to it. 

During the Startup procedure, all public volumes must be mounted; the 
system catalog must be on one of these volumes. 

Initially, Startup asks the address of the card reader. If the 
address is entered and there are cards in it. Startup reads the cards in 
answer to the questions below. If the address is defaulted, the follow- 
ing is a summary of a conversation between the operator and the system. 

Startup interrogates the operator for the address of the paging disk. 
During link-loading. Startup creates storage maps for initial virtual 
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storage, resident supervisor, and resident support system. (The resi- 
dent supervisor and resident support system are link- loaded together.) 
The message 

-PRINT MAPS?" 

asks the operator's direction for the disposition of these maps. 

The message 

ENTER CODE FOR FUNCTIONS NOT TO BE LOADED 

prompts the operator to exclude certain modules or functions from the 
load list. The last byte of the last word in each entry in the load 
list contains the code, which must have been preassigned (see the de- 
scription of the LLIST macro instruction in System Programmer's Guide ) . 
Modules containing Q-refs may be loaded into initial virtual storage. 
If two Q-refs of the same name are encountered and their attributes do 
not agree. Startup issues a message on the printer: 

ATTRIBUTES OF Q-REF xxxxxxxx IN MODULE yyyyyyyy DO NOT AGREE WITH 
PREVIOUS Q-REF OF THE SAME NAME — FIRST REFERENCE USED. 

If a CSECT in a user module is privileged, the privileged attribute is 
ignored and a message is issued on the printer: 

THE PRIVILEGED ATTRIBUTE OF CSECT xxxxxxxx WILL BE IGNORED. 

If a CSECT in a user module has the system attribute, the attribute is 
ignored and a message is issued on the printer: 

♦♦WARNING** USER CSECT xxxxxxxx HAS SYSTEM ATTRIBUTE. 

If duplicate CSECT names are encountered when loading a user module, 
the duplicate CSECT is not loaded and a message is issued: 

csect xxxxxxxx in module yyyyyyyy HAS DUPLICATE name CF previously 

LOADED CSECT — FIRST CSECT USED. 

User modules in initial virtual storage must have all relocatable con- 
stants resolved (that is, there must be no calls to modules outside ini- 
tial virtual storage) ; if an unresolved reference is processed by Star- 
tup, a warning message is issued on the printer: 

unresolved ref xxxxxxxx in module yyyyyyyy. 

Startup checks for the validity of the PMD of a module to be loaded into 
real or virtual storage; if an invalid PMD is found, a message is issued 
on the printer: 

PMD CSECT/MODULE xxxxxxxx INVALID — CSECT/MODULE IGNORED. 

The operator then receives : 

QUICK START REQUESTED? IF Y ENTER ADDR OF PACK FOR QUICK START DATA 
SLT EOB=N. 

^e operator may reply with a three- or four-character physical device 
address when the Quickstart data set is to be created, or with EOB to 
signify that creation of a Quickstart data set is not wanted. The 
address must specify a device on which is mounted a public or private 
VAM volume (perhaps the TSSRES volume) that is on-line during the star- 
tup operation and that has been initialized (CA3CI) with a copy of the 
Prelude on cylinder r track 1 r record 1. If a paging pack is speci- 
fied. Startup issues the message 



QUICK START VOLUME ON PAGING DRIVE QUICK START CREATION ABORTED 

and regular processing continues. Only one Quickstart data set may 
reside on a pack: subsequent Quickstart data sets created on the same 
pack will overlay the existing data set. If sufficient space is not a- 
vailable for the data set, the message 

INSUFFICIENT SPACE FOR QUICK START DATA SET QUICK START CREATION 
AEORTED 

is issued and regular processing continues. 

The request for 

"DELTA DATA SETS?" 

permits the operator to initiate the dynamic modification procedure (de- 
scribed in Part V). Upon completion of link-loading, the following ires- 
sage is then issued on the printer: 

THE PSEUDO-REGISTER VALUE AT THE COMPLETION OF STARTUP IS xxxxxxxx 
BYTES, if there are Q-refs. 

Then the operator verifies/enters the date and time. The Resident 
Support System (RSS) is entered by Startup to allow patches to be made 
before any TSS system operation. The requests for BULKIO and system 
hardware conf iguration validation complete the Startup process. A mes- 
sage stating that the startup process has been completed will be sent to 
the operator. The pre joined system programmer can logon and perform the 
system generation procedure as described in Part III. 

There are several program switches in STARTUP which can be set by the 
system programmer to affect the operation of STARTUP. These switches 
are located and set using the independent VAM2 utility (VAM2UT) : 



Entry Point 
Name 



Original 
Contents 



Set To 



Causes 



REMIPL 



U7F0 



U700 Question is issued to the operator 

asking if private IPL volume is to be 
removed. 



RSSCALL 


8 200 


4700 


PRINTALL 


5 8 DO 


4700 


JMPSWT 


00 


FF 


PRIEQPUB 


H710 


47F0 



4780 



Eliminates call of RSS for patch 
cards. 

STARTUP cards are printed on operator 
console. 

Bypasses printing of STARTUP cards. 

Makes all on-line volumes appear 
public. 

Reverses meaning of public/private bit 
on volume (see note below). 



Note : The PRIEQPUB switch can be used to operate a one-volume sys- 
tem, leaving the volumes from the normal user system on-line. The one- 
volume system can be used for test purposes, maintenance on the public 
storage of the user system, or for copying all the user public volumes 
as part of a vital records retention proaram. Public volumes will be 
recognized as private volumes without operator intervention. 
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SECTION 3; QUICK START 

Provided that a Quickstart data set was created during the initial 
Startup (see above) , the operator may initiate a Quickstart r a fast 
initialization procedure. After a Quickstart data set has been created 
(during the initial startup procedure) , any subsequent IPL can be made 
from the Quickstart volume. If that volume should be the TSSFES volume, 
IAM inquires if Quickstart or Startup is requested: 



System : 
Operator: 



QS 



If the Quickstart volume is not the TSSRES volume. Startup informs the 
operator 

QUICK START IN PROGRESS. 

If an unrecoverable I/O error occurs during the Quickstart process, the 
operation terminates with the message 

ERROR READING QUICK START DATA SET 
QUICK START TERMINATED 

The hardware configuration may be changed for a Quickstart except that 
the physical addresses occupied by the resident supervisor routines dur- 
ing the creation of the Quickstart data set must be available during 
Quickstart. 



Note: A Quickstart data set has VAN sequential organization, thereby 
allowing system access to the data set. The data set name is TSS*****. 
QKSTART . DSxxxxxx , where xxxxxx is the volume identification of the pack. 
The data set is cataloged if it is created on a public volume. The 
Quickstart data set may be created on any VAM- formatted volume (other 
than the paging volume) that has been initialized (DASDI) with a copy of 
Prelude on cylinder 0, track 1, record 1. A new Quickstart data set 
should be created whenever a new or revised module is added to the 
system. 

The Independent Access Method (IAM) data set has a VPAM organization and 
is created and cataloged, if created on a public volume, whenever a 
Quickstart dataset is created. The IAM data set name is TSS*****. 
SYSIAM. DSxxxxxx, where xxxxxx is the volume identification of the pack. 
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SECTION 1; SYSG EN 

The system generation procedure adapts a basic TSS to a specific 
installation's machine conf iquration, and to its task- management and 
command -system system options. Information about the installation is 
supplied in the SYSGEN macro instructions by the system programmer. The 
assembly of these macro instructions results in a module containing con- 
trol sections. The APGEN procedure applies these control sections to 
update the tables in initial virtual storage, resident support system r 
resident supervisor and conf iquration control block. 

The source coding for the SYSGEN module is a set of SYSGEN macro in- 
structions. GENSCB must be the last macro instruction. At least one of 
each macro is required. 

The module name supplied by the prejoined system programmer during 
the assembly process must be SYSGEN, The system generation macro in- 
structions are defined in the GENMAC and GENNDX data sets. Before 
assembling the macro instructions, the ASMMAC, ASMNDX, GENMAC, and 
GENNDX data sets must be defined and the ddnames must be supplied to the 
assembler as supplemental libraries and indexes. (Assembly parameter 
explanations are in Command System User's Guide , ) If a user, other than 
the prejoined system programmer (userid TSS), assembles the system 
generation macro instructions, he must have issued SHARE commands for 
ASMMAC, ASMNDX, GENMAC , and GENNDX. 

The SYSGEN macro instructions may be assembled conversationally from 
a terminal, or in a nonconversational task (see Figure **) , If the sys- 
tem programmer Is assembling conversationally, the macro instructions 
may be entered from the terminal or they may be defined, by using com- 
mand system facilities, in a data set that was prestored on a public 
volume. 

From the terminal, the assembler creates a source data set for the 
macro instructions as it processes them. From a prestored data set, 
successive lines are fetched and processed by the assembler. In both 
cases, the SYSGEN module must be assembled into a JOELIE with SYSGEN. 
MODULE as its dsname. 

In both cases, if any errors are detected prior to processing GENSCB, 
the macro instructions may be corrected and reentered; after processing 
GENSCB, the system programmer must rerun the complete assembly. Howev- 
er, if the system programmer is assembling in nonconversational mode and 
a macro instruction error is found, the assembler will process subse- 
quent macro instructions — but the complete assembly must then be rerun 
(see Appendix G). The TSS assembly procedures are described in the Com- 
mand System Usee's Guide . 

The linkaqe editor is used in the APGEN procedure to separate the 
SYSGFN object module into initial virtual storage, resident support sys- 
tem, resident supervisor, and configuration control block control sec- 
tions that are then used to update, in place, the appropriate system 
data sets. These control sections contain tables for use by the system. 

Section 2, "System Generation Macro Instructions," details each macro 
instruction and its parameters. Appendix A gives the format of each 
macro instruction with a short definition of the symbolic mnemonics 
used; and Appendix E, a sample list for the multi-processor machine con- 
figuration (pictured in Appendix D) , The conventions used to code the 
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system generation macro instructions are consistent with the require- 
ments of the assembler. 
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Figure 4. System Generation Phase 
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SECTION 2; SYSTEM GENERA TION MACRO _ I Nltf tUJCT I ONIJ 

Detailed descriptions of all system ^vhv -if ion .luvxr instructions are 
presented in this section, categorized by function: configuration, 
task-management and command- system, '"♦•<<.• sys «'-cm- table generation. Within 
each subsection, the descriptions are in a i pi-abotioa.) '--rder, and each 
description has this arrangement; 

1. Macro instruction name. 

2. Brief statement of the macro instruction*-! functions. 

3. Illustration of the macro instruction * s juc;cic.»t« 

4« Detailed description of each operand. 

5- System d€*fault value; when none s ; • eoi.lif-d , tnei. o is m; system 
default. 

6. Programming notes, where apt! o ^h < ^ P t s )<'. <A\\i'.\-\' oroper use, 
restrictions, and limitations. 

CONFIGURATION MACRO INSTRUCTIONS 

The configuration macro instructions must t«e sj eci ! led in tne follow- 
ing order; CPU, STEM, CH^NiiEL, DCU and UEVCIO „ i»ni-:t-r> the macro in- 
structions accurately reflect the i nst «dl Lu t ius * s cos 1 t .jur at ion and ail 
its device features, TSS will not work efficiently; system errors may. 
occur. tor example f such an error would occur* ;. f t;^ asynchronous fea- 
ture was omitted from a description of a terminal device. 

Other features, such as control units anl switches, are required 
equipment for TSS . No mention n^ed be made v. suet features or equip- 
ment in the macro instruction specifications, unless . peeifically re- 
quired by the macro instruction? tin-Mr exi.stP-K <•> i>\ n ! «p tied when the as- 
sociated equipment is specified. 

If, subsequent to the initial s/stem gener^tios r ui, new devices are 
to be added to the system, another system -.viu* r..jt i on run is necessary. 

All the information supplied by the initial. ;ystem .i^*i»?tat ion macro in- 
structions, plus the additional, d^vjer j nt)?;, it > ^n , :->.'s*- be used for the 
second system generation run. 



CH AN J EL - "1 Jjc -ic t_ibe_ Cha nne Is on *• . 1 1 J 

Tne CHaWNjSL macro instruction sp*vi t- -. ♦. .. i : .• hu: cos .»' s of the byte and 
olock multiplexer and selector eh »nn»- i s .mi 'it- .-y:it,Hi sonf iguration. 

(Name (Operation (Operand | 

l- . .„„ + _„_„_ + „„ . - „„„„„__{ 

| [symbol] |CiIANiSIEL | Cl>U= I | W r Mlt< • ( hex ' tl' *»u* - 1 , . . . ! \ 

| | j [,SLI/- Clm-xmc-' g«r, . , . ) 1 [,i?.r:>- ■ Hk:x integer r ...) J j 

CPU 

specifies the address of the CPU associated with the channels. 

Specified as : one hexadecimal di q ) t , or 1 

iMPX 

specifies the addresses of byt^ multiplexer ctiaii.iels. 

IMrt 111- Sp*;ci f / ing the System 11 
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SEL 



BMX 



Specified as s one hexadecimal digit, to L 

specifies the addresses of selector channels. 
Specified as : one hexadecimal digit from to D 

specifies the addresses of block multiplexer channels 

Specified as : one hexadecimal digit from to u 

Programming Notes : One CHANNEL macro is reguired for each CPU with 
channels attached. Trie channel addresses are mutually exclusive on each 

CPU. 

CPU — Describe Central Processing Units 

The CPU macro instruction describes the number of central processing 
units . 

r _ T . . T — . . _ 1 

| Name [Operation | Operand | 

!_„_ + + __ . .. j 

| [symbol] |CPU |nocpu-{l|2> I 

L. ._ ,—L . JL „ . J 

nocpu 

specifies the number of CPUs, including attached processors, in the 
system configuration. 

Specified a s: 1 or 2 

DCU — Describe a Device Control Unit 

The DCU macro instruction identifies an individual device control 
unit in the system configuration. Input/output devices that include 
their own control units also need a DCU macro instruction. 

r _. T _™ . — . T . . . . 1 

j Name | Operation | Operand | 

H „ + .__„__ + „ .„_ __ _ _ „ H 

j cuname | DCU | UNIT=code , PATH= C hexinteger-hexinteger , . . . ) | 

| I | | [,M0DEL=C1|2|3|4| 5| 6|7| 8)1 t^SHARED={ Y| iO 1 | 

L . X J. .. .„ . J 

cuname 

specifies the symbolic name by which this control unit will be 
known. This control unit name may be used as an operand to the 
VARY command. Each control unit must have a unique cuname. 

Specif ied as : one to eight character alphameric name 

UNIT 

specifies one of the control unit types. The 1052 unit must be 
specified only for the operator consoles, which are hard-wired ter- 
| minals. NONSTD indicates a control unit that TSS software does not 
j support but which can be handled via IOKEQ (described in Assembler 
| User Macro Instructions ) . 

j Specified as : 1052, 23ia, 2403, 2501, 2701, 2702, 2703, 2803, 

| 2821, 2835, 2840, 2841, 3066, 3213, 3215, 3272, 3505, 3704, 3705, 

j 3800, 3803, 3811, 3830, NONSTD 

12 
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PATH 

specifies the base control unit address and the range of addresses 
to which the control unit will answer. The address is a four digit 
hexadecimal number- The first digit of the control unit address is 

the CPU address, the second digit is the channel address, the last 
two digits are the base address of the control unit. The range is 
a dash followed by a two digit hexadecimal number that specifies 
the largest possible address which is answered by the control unit. 

Specifi e d as ; Four nexadecimal digits followed by a dash followed 
by two hexadecimal digits. 

Programming Notes : The range must include ail addresses that the con- 
trol unit will respond to, even if the devices are not specified in a 
DEVGRP macro or even if the physical devices are not installed on the 
control unit. 

MODEL 

specifies the control unit model number. This operand must be pro- 
vided if the model number exists. 

Specified as: one hexadecimal digit from 1 to 8 

SHARED 

specifies whether or not a NONSTD control unit has a single sense 

register shared among attached devices. 

Specified as : Y or N 
System Defaul t : N 

DEVGRP — Describe a Device Group 

The DEVGRP macro instruction describes a group of devices of the same 
type that are connected to the same control units. 



(Name 

I 



j Operation | operand 



[gpname (DEVGRP |UMIT=code,PATH= ( Ccuname, hexinteger) , ) 

, r ADDRESS=( (hexinteger,hexinteger ),...) 
L,MODEL=code] 
[ f FEATURE=(code,.. . )1 
[ f MAXIG= integer] 
i , TYPE= { RESERVED | ASYNCH } J 
[,IOREQ={YES|NO}] 
[ f CONTRL=£2701|2702| 2703}] 
£ # HOLD={Y|N}] [,DDSDA={Y1N]] 
[ # ABCJF=integer] [, DCM= integer] 



gpname 

specifies the symbolic name by which this device group will be 
known. This device group name may be used as an operand to the 
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VARY command. Several DEVGRP macro instructions may be used to 
logically describe one device group by repeating the gpname. 
Examples of string switched devices are given in Appendix J. 



Specified as : one to eight character alphameric name 



UNIT 

specifies the device type. The 1052 printer-keyboard, 1053 printer 
and 10 56 card reader are included under the 1050 unit designation. 
The punch and reader functions of the UjM 2 54 card read-puncn are 
referenced by 2540P and 2540R, whicn are separately addressed and 
must be listed in separate DEVGRP macro instructions. The 3 330 
Model 11 is specified as 333B. NONSTD indicates a device that TSS 
software does not support but which can be handled via ICREQ (de- 
scribed in Assembler User Macro Instructions ) . 

Specified as : 1050, 1403, 2305, 2311, 2314, 2401, 2402, 2403, 
2501, 2540P, 2540R, 2741, 2780, 3066, 3211, 3213, 3215, 3270, 
3270C, 3330, 333B, 3350, 3U20, 3505, 3525, 3704 f 3705, 3800, TTY33, 
TTY35, NONSTD 

Programming Note ; When sysgening the 148 or 158 operator's console as a 
3270, the unit value in the DEVGRP macro must be given as: 

UNIT=3270C 

This denotes a 3270 without a PA1 key. RTAM will thus assume that an 
exclamation (!) character entered by itself is an attention request. 

PATH 

specifies the list of control units which can access the device 
group. Each path entry specifies the control unit name (specified 
in the DCU macro instruction) and that portion of the hardware 
address contributed by the device group interface to the control 
unit. The cuname consists of one to eight alphameric characters. 
The device group interface address modifier consists of one or two 
hexadecimal integers. 

Specified as ; (alphameric name, hexadecimal digits) 

Programming Note s The device group interface address modifier is usual- 
ly used to specify string switched direct access storage configurations. 

For most device groups, this parameter is specified as zero. 

ADDRESS 

specifies the relative hardware address and the symbolic device 
address. The first operand, the hardware address, is tne address 
of tne device relative to the base control unit address and con- 
sists of one or two hexadecimal digits. The second operand, the 
symbolic device address (SDA), consists of one to three hexadecimal 
digits i it is used as the external identification of the device. 

Specified as : (hexadecimal digits, hexadecimal digits) 

Programming Note ; The complete physical address of a device is formed 
by adding the base control unit address (specified in the DCU macro in- 
struction) to the device group interface address modifier (specified in 
the PATH operand of the DEVGRP macro instruction) to the hardware 
address (specified in the ADDRESS operand of the DEVGRP macro 
instruction) . 
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MODEL 

specifies? the device model number; must be provided if the device 
has a model number. 

Specified as : any digit, or Nl 

System default ; null 

FEATURE 

specifies applicable optional features that are on the devices 
and/or associated control units. 

Specified as : 

Code 
TROFL 

SCAN 

DATACONV 

BTS 

WCGS 

7 -TRACK 

9 -TRACK 

AUTOCALL 

DIAL 

DEDICATED 

SADZERO 

SADONE 

SADTWO 

SADTHREE 

UCS 

BSYN 
SINGDENS 
DUALDENS 
COLBMRY 



Feature 

Record- overflow feature on 2311 or 2314 

File-scan feature on 2841 

Data-conversion feature on tape control 

Burster -Trimmer- Stacker Feature on the 3 800 Printer 

Writable Character Generation Storage Positions 
Feature on the 38 00 Printer 

7 -track head on any tape drive 

9-track head on any tape drive 

Automatic dialer 

Dial-up line 

Dedicated (hard-wired) line 



Communications lines on 2702 
Transmission Control Unit 
initialized by 
corresponding set adapter 
(SAD) value 



Universal character set printer feature on the 2821 
control unit for the 1403 printer 

Bisynchronous adapter 

Single density 3420 

Dual density 3420 

Column binary feature on 2501 or 2540 Reader or 
2540 Punch. 



System default : For 2702 or 2703, if neither DIAL nor DEDICATED is 
specif i€sd (only one may be specified) , DIAL will be assumed. For 
3420 SINGDENS will be assumed. 

Note: The SAD (set adapter) value associates the 2702 Transmission Con- 
trol Unit and line oscillator (terminal adapter n, where nisO, 1, 2, 
3) with the addressed communication line. The SaD value is ignored on 
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the 27 03 and 3705 Transmission Control Units and is invalid on the 2701 
Data Adapter Unit. 

The features of nonstandard units (UNIT=NONSTD) must be specified be- 
setting up an eight-digit hexadecimal field that corresponds to the 
device-code field CSDADEV) in the TSS symbolic device allocation table. 

This table describes the characteristics and status of each separately 
allocatable input-output device in the system (see System Control 
Blocks) . 

The form used to specify features of nonstandard units is 
FEATURE^ ( X f hhhhhhhh ' ) 
This procedure also may be used for standard units. 

Note ; The subfields are not in the same order as are those in the IBM 
Operating System. In addition, some codes differ from those used in the 
Operating System. The user should check all code values against the 
meanings defined for CHASDA in System Control Blocks ; otherwise unpre- 
dictable results may occur. 



MAXIO 



specifies , for any one task, the maximum number of input/output re- 
quests that may exist at one time for a device in this group. For 
a device that is to be serviced by MSAJM (multiple sequential access 
method) , the installation specification for MAXIO determines the 
number of page buffers used and should be at least three for prin- 
ters supporting the FORMAT option. 

Specified as; decimal number 



TYPE 



System default ; 2 

specifies the type of device (if required). 
Specified as : 

Code Meaning 

RESERVED Device reserved for system use, such as tape drive 
needed oy system error routines, SIPE, etc. 

ASYNCH An asynchronous interruption from this device causes 
a task to be created, if none exists. 

Caution : If ASYNCH is specified, it is the nsa's 
responsibility to insure that the UNIT operand speci- 
fies a leqitimate terminal or RJE device of the 
system. 

System default ; n u 1 i 



lOREv 



specifies if I0REQ is to be permitted to access the devices de- 
scribed by this macro instruction; YES specifies that ICREQ is per- 
mitted; NO, that it is not. 

Specified as ; YES or NO 

Syste m default : NO 
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CONTRL 

specifies the transmission control unit to which all terminals in 
the group are attached. 

Specified as ; 2701,270 2,2703 

System default : 2701 if UNIT=2780, 2702 otherwise. 

Note: With the IBM 2780, if CONTRL=2701 is not specified the sys- 
tem default is CONTRL=2 701, and the assembly completes with a warn- 
ing message. 

HOLD 

specifies whether or not devices in this device group will be 
marked held at startup time. 

Specified as : Y or N 

System default : N 

DDSDA 

specifies whether or not W U W class users may specify devices in 
this device group with the SDA in the UNIT operand of the DDEF com- 
mand (Ascribed in Co mmand System User's Guide ) . 

Specified as : Y or N 

System Default : N 

ABUF 

specifies the number of 64-byte blocks that the system may allocate 

as buffers for a terminal device. 

Spec ifie d as : decimal number 1 - 25j 

DCM 

specifies to the system the specific device control module that is 
to be called on an initial asynchronous interrupt from a terminal 

device. 

Specified as : decimal number 1 - 255 
Programming Note : The recommended values for ABUF, DCM and HOLD are: 



device type 


ABUF 




DCM 


HOLD 


2741 


32 


or 


64 


2 


Y 


TTY33, TTY35 


32 


or 


64 


3 


Y 


1052-7 


64 






4 


N 


3213 


64 






4 


N 


3215 


64 






4 


N 


3270 


64 






7 


N 


3270C 


64 






7 


N 


3066 


64 






8 


N 



I OPCNSL — Define Operator Consoles 

| The OPCNSL macro instruction is used to define to the system the 
j default system operator consoles and the message codes to be routed t:o 
I them. 
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| j Maine | Operation (Operand | 

| | Isyfttool] iOPCNSL | CSliAt # ALAKl^ r RSS f Kj"io # SY::u«i;;^ rA 4^LCP\ t -SY.-:i Rh J ) , . . . | 



j s p e c i t i e 55 the s y mbo lie d e v i c e add res s o t t h e o p eratoc c o n s o I e . 

| Oi^^lJlA^i. § s : a hexadecimal number denoting the console to receive 
| tne given message cypes. The? ioi lowing messag*-- type.', axe 

| r^p^ottca; 

| -hL.nFtN - this SDA contains an alarm which Is tc be rung when a dYS- 

j ERROR occurs and the system is stopping. 

j BkDCPY - denotes a hard copy console on which all sy stein n.^M^o ges 
| are to be printed. 

| aSS - denotes the console to be used as the RSS Master System 

j Programmer console. RCS when activated will use the spec- 

I ified ccnso.ie as SYS1N/SYSOUT. 

■ RMS ~ denotes the console to receive any messages issued by tne 
l Recovery Management System (HMO) . 

J S\S>s-0 - denotes the consoles tc; receive any supervisor inessjges 

: .' •••Hv'i l.hr ■■.] j- \.i)-. CY;-r. ; '-:Cy '••.■*;«.■ "< i r.i'-A .1 itv r 

I n'v.shKR - denotes the consoles to receive any SYSERR displays. The 
>''x.A os e.- : -..■..!, wi ; ;. c wt;.c. ■-.■• J ■ m.c denon ou . ^. ■•.■;. ••.'."■ O yt 

| the console:' marked as r RSS f is the one used by RSS tor 

J command input and output . 

I . *: jni rX ] { ^lj}:A„^9Jr*!r : " L ' ue devj.c^ type ol tSiO specified oDAs must, be one or. 
i ii ' .• 1 low i rig : j. b 2 - 7 , J 2 1 J , 3 2 1 r ) r J <^ 7 ,,. .< 2 7 C , ?. fo b . 

",e Id*-":-! sacs.; Lypes may be specifier f est it!c£0 t Siui; one SDA. The system 
;» rio.^casl the following message fypos to ail the consoles marked to 
, • '..five the same; RMS r SYSMSG and r»Y;>! '4, h copy of the message will 

:'''-•>) To .coat to ciii console.) marked as HRiX'Vtf ty^es. 

» "O* tne A LARK ana k'3P» console indicatory, if more than, one console is so 

■ >"iarked f she system will use the firsc console found online and ignore 
, the rest. 



Any console /larked with the ALARM actL.tbete. lisust support the "ALARiV CCW 
operatiui code (X'OB); otiierwi.se, the -aianr* will not be mounded. 



; i' .e j rocneTI usco t^ Ai'r c he ^.y.a.^Hi is 'i.rirke'i in i.ae console table <:,,- 

I i ne »V , console. This is the default, console for all miess-igcs and coi; 

! tne RSS 3Y8IN/SY5GUT it one was not given. j i the console was not- 

| ai ready in Oie table f STARTUP adds the console to the tacie ir-ing one of 

| i a e '-'Xt.r a e ni lies b o i 1 1 by S Y SG E h . 

j ^YCGiO nui Ids in 10 extra entries to be used for dynamically adding con- 
j so J e.o to the table. 

:f ;;0.M ;• •;• ^jiSC-.. xbe 1 1 : O^SbOT; ^t c ± «J OS Jti^lOrl^ST 

The STEM macro instruction is used to specify the number of pages 
C4 096 byte blocks) of real storage in the system. 
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r _ ... — _. — T „„„_ — — .. — r — _„„_ _ . _. -.„, — . 1 

(Name (Operation (Operand | 

|_ . „ t _«_„__ + ______„.______„. j 

| | C symbol] (STEM ) number- integer, sup- integer J 

L_______-i...__„_~.__«_„A___-„„.„. _„. - . _____ ... ___ i 

number 

specifies the number of pages of real storage in the system 

Specified as ; decimal number from 256 to 4096 

Syste m default : 256 

1 sup 

1 specifies the number of pages of real storage to be assigned for 
| use by the resident supervisor. These pages begin at real storage 
j location zero and continue contiguously for the number of pages 
j specified. Pages of real storage within the "sup" range cannot be 
| varied by the VARY command, 

I Specified as ; a decimal number from 128 to 4096 

I Defaul ts 256 

I Programming note : On very large system configurations , the "sup" value 

j should be no less than 256 pages. A smaller number of pages may cause 

| system performance degradation , or the system may abort with insuffi- 

I eient storage for supervisor requests. The "sup" pages include the 

j resident supervisor object code, tables, and transient real storage re- 

j quired by the resident supervisor. 



TASK MANAGEMENT AND COMMAND SYSTEM MACRO INSTRUCTIONS 

The task- management, system generation macro instructions that speci- 
fy various parameters for dispatching and controlling tasks within TSS 
are DISPAR, TSKLMT, and VMPAR. 

The command- system system generation macro instruction CLOP provides 
default parameters that are to be supplied by the system for various 
commands (and their macro instruction forms). 

Because these macro instructions determine, to some degree, the effi- 
ciency of system operations, their parameters must reflect the work be- 
ing processed at an installation. The choice of parametric values 
depends upon an installation's configuration, workload, and system ob- 
jective. To adjust parameters, another system generation run is 
required. 

CLOP — Specify Command System Options 

The CLOP macro instruction specifies certain default parameters for 
command system and macro instruction processing* 

Part III: Specifying the System 18.1 



PageofGC28-2010-7 

Added February II, 1978 
By TNL GN20-38O9 



I Name 



h 



| Operation f Operand 



[symbol] jCLOP 
! 



PRMTLMT= integer 

f PRVLG=(code f , . . ) 

,AUTH=fU|P} [,DSORG=code) 

,DATYPE=[2311| 2314| 3330|333B| 3350} 

r TATYPE={7|7DC|9Dn> 

f DEN=--tO|l|2 | 3)4} [,LABTxP={NL|SUL| SLlJ 

,DAPAGES= (integer 3 - ^integer 2 ) 

,DACYLS= (integer*, integer 2 ) 

r DATRKS=integer 

r LIBPGS=( integer 1 , integer 2 ) 

f , CFM~alphnum] [ , PFJ>i=alphnumJ 

[ , MAV=integer ] 

I , PRIG-integer] 



PRKTbMT 

specifies the installation's prompting limit; that is, the maximum 
n Limner of times the system will repeat a message when signaling the 
operator and when prompting the user. r the highest value that can 

be as s i a Tied i s 255.. 



b i ; e c i i i e d_jc 



dee ima 1 number 



i RvJ/i 



specj ties toe privilege classes that may be assigned at join-time. 

Each privilege class is designated by an alphabetic character other 
< hrin a (reserved fox system operator) and 1 (reserved for system 
manager) . The first, privilege class specified becomes the default 
class. Privilege classes are described in Manager's and Admin is- 
t cut or * s (- aide. 



Specified 



alphabetic character (other than A and F) 



A'.!T.fi 



.ee :.:.!«'<; r.bc deiuu.lt authority code assigned to a user when he is 
i : "-\j t-e ti>e system; p indicates systems programmer authcrize^tion, 
indicates no system programmer autnorization. 



Specit iea as: P or U 



a.SORG 



'•t-'eciiies the default for the positional dsorg (data set organiza- 
tion) parameter of the DDEF command and macro instruction. 
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Specified as : 

Code Organization 



PS 
VI 
VS 
VP 



physical sequential 
virtual index sequential 
virtual sequential 
virtual partitioned 



System default : VS 

DATYPE 

specifies the type of direct access storage device to te defaulted 
in commands and macro instructions. 

Specified as: 2311, 2314, 3330, 333B, or 3350 

TATYPE 

specifies the default value for the tape drive type if 
omitted in a DDEF command or macro instruction. 



DEN 



it is 



Specified as : 

Value 

7 

7 DC 

9D2 

9D3 

9D4 



Meaning 

7-track tape 

7-track tape with data conversion 

9-track tape , density 800 bpi 

9-track tape, density 1600 bpi 

9-track tape, density 6250 bpi 



specifies the default value for the DEN (tape recording density) 
parameter of the DDEF command or macro instruction. 

Specified as : 



DWI value 



h 



Tape recording density (bits/ inch) 

r 




1 
2 
3 

4 



I 



7-track 



200 
556 
800 



+ - 



1 

I 
_ ^ 

9-track \ 



800 

1600 

6250 






Note: No checking is performed to ensure that the DEN value is 
compatible with the value of TATYPE. DEN values of and 1 should 
not be entered for 9-track tapes. DEN values of 3 and 4 should net 
be entered for 7-track tapes. 

LAE1YP 

specifies, for magnetic tape data sets, the default for the parame- 
ter of the; DDEF command or macro instruction. 

Specified as : 

Code Meaning 

NL No labels 

SL Standard labels 

SUL Standard and user labels 
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System default ; SL 

Note : The next four operands specify the primary and secondary data set 
storage allocation that is to be assumed if this information is 
defaulted in the SPACE parameter of the DDEF command or macro instruc- 
tion. Primary storage is the initial space allocated to a data set; 
secondary storage is the space to be allocated each time the space pre- 
viously allocated to the data set has been exhausted and more data is to 
be written. At most, a three-digit number is permitted for each sub- 
operand. The values assigned for primary and secondary storage are de- 
termined independently. 

DAPAGES 

specifies the number of pages used for the default primary- and 
secondary-storage allocation of VSAM, VISAM r and VPAM data sets. 

Specified as : (decimal number, decimal number) 

DACYLS 

specifies the number of cylinders used for the default primary- and 
secondary- storage allocation of BSAM or QSAM data sets. 

Specified as : (decimal number, decimal number) 

DATRKS 

specifies the number of tracks used for the installation default 
secondary- space allocation of BSAM or QSAM data sets. 

Specified as : (decimal number) 

LIEPGS 

specifies the number of pages to be allocated for primary and 
secondary storage of a USERLIB. 

Specified as : (decimal number, decimal number) 

designates the installation default identification for punched card 
forms. It provides the name by which the system will identify the 
installation" s standard card form. 

Specified as : a string of not more than six characters; if a long- 
er string is specified, it will be truncated to six characters from 
the right. 

System default : CARDS 

designates the installation default identification for printer 
forms. It provides the name by which the system identifies the 
standard combination of paper form, print chain, and carriage con- 
trol tape used at the installation (see the description of SYSUCS 
and SYSURS under the discussion of the SETUR macro instruction in 
System Programmer's Guide ). In the system received from IBM, the 
default syirbol provides the values shown in Appendix G of System 
Programmer's Guide . 

Specified as : a string of not more than six characters; if a long- 
er string is specified, it will be truncated from the right. 

System default : PAPER 

specifies the default number of auxiliary storage pages assigned to 
a task durina its execution. 



CFM 



PFM 



MAV 



20 



Specified a s: decimal number 



System default : 256 



PRIO 

specifies the default priority that will be assigned a user being 
joined to the system without a specified priority. 

Specified a s: a decimal number, to 9. 

System default : 8 

DISPAR — Specify the Dispatching Algorithm 

The DISPAR macro instruction specifies paging and timing parameters 
for the dispatching algorithm, which is the TSS mechanism for scheduling 
available processing time among the tasks within the system. 



[Name | Operation (Operand 
I- h 



[ symbol ] JDISPAR 



L . JL 



|LCT=(integer 1 ,integer 2 ) 

1 1 ,LDOTR=integer] [ ,PURGSB= integer] 
[ ,THRESH=integer] t , EUFSIZ= integer] 
[ r AUXSP= (integer , integer ) ] 
[ ,INITLVL=integer] i ,TCR=integer] 

j L ,BLKSZE= (integer jL ,integer 2 ) ] 



1 
J 



LDMTR 



LCT 

specifies the number of pages that must be available (or about to 
be written] in storage before a time- si ice for another task can be 
started, A lower and an upper threshold must be specified for the 
available pages. 

Specified a s : (decimal number, decimal number) 

specifies the percentage of the paging drums that remains to be 
allocated to auxiliary storage before overflow to paging disks 
occurs . 

Specified a s: integer 

System default ; 2 

PURGSH 

specifies -the maximum number of shared pages to purge 

Specified as : decimal number 

System default : 2 2 

THRESH 

specifies the scan shared pages threshold 

Specified as : decimal number 
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System default : 10 

BOFSIZ 

specifies the buffer size on the drum 

Specified as : decimal number 

System default : 64 

AUXSP 

specifies the auxiliary stop and primary threshold values 

Specified as : (decimal number, decimal number) 

Note : The second number must be greater than the first. 

System default : BUFSIZ+10 ,100 

INITLVL 

specifies the initial Schedule Table level to be used for task 
creation. 

Specified as : integer, to 255 

System default : 20 

TCR 

specifies the task core requirement, the value by which Startup 
divides the number of available main storage blocks to calculate 
the maximum number of tasks that can exist concurrently in the dis- 
patchable list. 

Specified as : decimal number 

System default : 55 

BLKSZE 

specifies for each task the maximum number of pages to be written 
in a blocked format to drum and the combined maximum number of 
pages to be written in a blocked format to drum and disk. 

Specified as : (decimal number, decimal number) 

Note : The second number must not be less than the first. 

System default : (12, 20) 



PUEVQL — Generate Public Volume Table 

The PUBVOL macro instruction specifies the parameter needed to gener- 
ate the public volume table. 

f 1 1 _ 1 

SName [Operation ] Operand | 

j. + + f 

I [ symbol 1 j PUBVOL | MAXVCL=integer | 

MAX VOL 

specifies the maximum number of public volumes that are in the 
configuration. 
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Specified as : decimal number 

Note : One and only one PUBVOL macro instruction is required for system 
generation. The number of public volumes specified should be suffi- 
ciently large to allow for future expansion. 



TSKLMT — Specify Task Limitations 

The TSKLMT macro instruction specifies the system limits on the size 
and number of tasks, by type, that will be allowed to operate 
concurrently. 



% _ 1 T n 

| Name (Operation [Operand | 

v i 4 , 

[ symbol ] | TSKLMT |CONV=integer ,MTTADM=int eg er r BATCH= integer 

1 

I ,BACK=integer,PGTEL=integer 

I 

| [ ,PSLMT=integer) 

I 

1 [,OVRAUX=integer] [ ,RTAMEUF=integer] 

L J . JL . . J 

CONV 

specifies the maximum number of conversational tasks that the oper- 
ator may allow with the FLOW command. This value also represents 
the initial conversational task limit; an attempt to create a con- 
versational task beyond this limit produces a message at the user 
terminal, and the keyboard is set to receive the next input from 
the terminal. 

Specified a s: decimal number, greater than or equal to 1. 

MTTADM 

specifies the maximum number of MTT administrator tasks that the 
operator may allow with the FLOW command. This value also repre- 
sents the initial MTT administrator task limit; an attempt to cre- 
ate an MTT task beyond this limit produces a message at the user 
terminal, followed by an underscore. 

Specified a s : decimal number 

BATCH 

specifies the maximum number of tasks, initiated by a command pro- 
cedure read in by BULKIO or by an EXECUTE command, that the opera- 
tor may allow with the FLOW command. The system will initiate new 
tasks only if the number of batch tasks currently executing is 
within this linit. 

Specified a s: decimal number 

Note : This limit must be set less than the task limit allowed any indi- 
vidual user (see System Programmer's Guide , Appendix H) . 



BACK 



specifies the maximum number of background tasks (conversational 
jobs made nonconversational by issuance of EACK commands) that the 
operator may allow with the FLOW command. This value also repre- 
sents the initial background task limit and an attempt to create a 
task beyond this limit will produce a diagnostic message at the 
user terminal, followed by an underscore. 
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Specified as : decimal number 

PGTBL 

specifies the maximum number of ma in- storage pages that may be 
occupied by the page tables (and associated information) for one 
task. This limitation constricts the actual size of virtual stor- 
age that may be us ed by a task. If this limit is exceeded, the as- 
sociated task is terminated abnormally. 

Specified as : decimal number 

PSLMT 

specifies the maximum number of public segments to be allocated to 
any operational task. 

Specified as ; decimal number 

System default : 100 

OVRAUX 

specifies the percentage of auxiliary storage space that an instal- 
lation can overcommit. 

Specified as : decimal number, to 99 

System default : 

RTAMBUF 

specifies the number of work pages to be allocated in virtual stor- 
age for the terminal access method at task logon time. 

Specified as : decimal number 1 to 16 

System default : 8 

VMPAR — Specify Virtual Storage Parameters 

The VMPAR macro instruction specifies parameters used in the alloca- 
tion and manipulation of virtual storage. 



JName j Operation (Operand j 

j. 4 + _ f 

| [symbol] ] VMPAR ( IVCSLNG={ integer | SEGMENT}] , SDST=integer 

I 

I I, 0PTICNS= (code ,-..)] 

I 

| [,TIME=integer] 



VCSLNG 

specifies the increment (in pages) to be added to a request for a 
variable amount of virtual storage. SEGMENT specifies a 255 -page 
increment . 

Specified as : integer (in range 1-255) r or SEGMENT 

System default : 20 (also assumed if an invalid integer is 
specified) . 

SDST 

specifies the number of pages to be assigned to the shared data set 
table. 
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TIME 



Specified as : integer (maximum 256) 

OPTIONS 

specifies the virtual storage request or supervisor options. 

Specified as : 

PUBSEG shared VM allocation requests are to be packed into any 
available shared segment group. These segment groups 
are known as public segments. If PUBSEG is not speci- 
fied, each shared request will be allocated a new shared 
segment group. 

Note: Packing refers to assignment of successive pages 
of a segment, not to condensing information within 
cages . 

PACKSEG private VM allocation requests are allocated on page 

boundaries. If PACKSEG is not specified, each private 
request will be allocated on a 16 page boundary. 

WCDISK Page-writes on disk used as an auxiliary paging device 
and writes of VSAM, VTSAM, and VPAM data sets (which 
must be on direct access devices) are to be validity- 
checked. For BSAM data sets, the corresponding option 
is specified individually by the user in either the DDEF 
command or macro instruction or the DCB macro 
instruct ion. 

specifies the initial task time interval to be assigned for each 
task. Upon elapse of the specified interval, a task is abnormally 
terminated, in the background mode; or the user is notified, in the 
conversational mode. The TIME command can be used to change the 
task timer settings for each task. 

Specified as : eight unsigned, unpacked decimal digits HHMMSSth, 
where the maximum value for each field is: 

HH (hours) <07 
MM (minutes) <59 
SS (seconds) <59 
t (1/10 sec) <9 
h (1/100 sec) <9 

The composite range is from 1 second tc 7-1/2 hours. 

System default : one hour 



SYSTEM TABLE GENERATION MACRO INSTRUCTION 



GENSCB — Generate System Control Blocks 

The GENSCB macro instruction causes the generation of the object 
module (SYSGLN) that contains the system control blocks. These blocks 
reflect the parameters that have been specified in other system genera- 
tion macro instructions. 
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(Name | Operation [Operand | 

I ., + 4 

| Isymboll j GENSCB \ 1 

L J J . . . J 

Programming Note ; GENSCB must be written as the last macro instruction. 
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jiice it; the procedure by which the system programmer 
j>-s ihk -sip 'plied maintenance packages to an operational 
:Oinroand system modifies system data sets according to 

<■. n ;-;<•-*,-.. on the change tape, as described below. (See 
lactam of the system maintenance procedure.) 

"••■i * -■<;;! •»;.i%t u*:;iJH.::e rolt\:se f IBM distributes a VAM change tape to be 
u ■'.*:-.* - •- i.jv; .-."« •••M-'r-.itiono.j. ..c-snion on the latest released TSS system 

'!td, . f .-H' 1 . ■ « "vs i.^. v , ^ tape that contains a copy of the latest independ- 
ent, .) ; - « , it •' »?;■>. tae change tape contains a copy of the modified source 
■ iou - :' , « a.: J Lie ct.ftj an update :-;oi:i pt (of command language statements) 
tha+ (.ot>. ^oi.* v. bo ip^-^te as tile two, and several files that, when 
copied it, direct cecefv devices by tne update script, become VPAM, VSAM 

o?--i V"'..r\i ; 0-j:^ uets that contain the replacement modules and changes to 
<.., - -v.' . : ' ''. ,i,.«Cn t-v >r ^ "<> romi i«te the maintenance release update in 
el av • , 

'• ' k e^-i.e* "- ^y^ ^ay be ui'v?d in its distributed form to update a sys- 
tem 'i....,t. '<. ■ . re .be ii;rOi;j.t<.! . -y I jLijto- supplied maintenance packages excla- 
■»'. v..S>- o-- ,, i^'ore < : ..pf lying the-: change volume to a system containing 

\x • } • :.'t ; Oj».' , rhv' specific requirements of the installation may be 
I -*.*-?'■' oy Ui. : i*i<r the existing system to modify the change data set 
;.. {.*■**.-■ i 'i'lOiit u,jO tar»e to external storage. The replacement 
o\ -*; r >: : rid i. :-;t'..<r.v^, are in delta data set form ior SYSIVM, 
ti:'j •••:..».: : : t. -./. . oo:tsc-quently t if the update script is suitably 
; ' :,* * th' •-.. iatt't sets to a delta volume, the dynamic rcodi- 
i |w Kvain-: v. 'in be used to ascertain the effects of these changes 
ra> -,\ -■■•;{~u ''^''jr': procedure permanently modifies the system (see 
PAH* V ; > ; r.t- -..y^tow .-, cvvtt: oi SYSLIB changes can be ascertained (prior 
tc .-•♦<.:•• •■•\-utO ry ^..^n. JGBLIB facility of the dynamic loader (except 
^lO^lVt a- ■'. ot^.. 5 i'' cjiiauyeel, (However, if STARTUP, PRELUDE, SYSIAM, or 
.-*i>l;-i .!:'<; in«"ioJed, t h--y must be moved to the IPt volume to be tested.) 

';':*< ■ ■ " i.- ; 'i oui ce oodules (along with the original source modules) 
ciftt <k.,v-v > e.o.-tro: ated as one blocked tape file CSYSIMO format). Multi- 
ple V'.i-AM ,- f „;,rrce data sets are created from this file by the use of the 
SISlMO p w 'v ; t'a-\. r - complete description of this program may be found in* 
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"•..-•■ d..»ta set. .s that may reside on the change tape are listed below. 
,)i •<«.•*> e, -m ; ^ ii.ose needed for the modifications in a specific mainte- 
?:ith'>- , >■■> l*> -i ;i- wiii be on the change tape for that release. The modified 
: :'oi,o : 'x. ?ulv. .• d!:,d TAPE, SCRIPT are the first two files on ail mainte- 
,e-rc:r< •- A *.■■.■! r .-r t^n-s, The remaining files include only changes for those 
«.,r»r'- ,r.c-. .v r« i fj ..* c t *-'d during any specific maintenance release* 



• i' 



idpe consists only of data sets owned by userid TSS*****; 



when .-• 1 ciiia s^ts are impacted, the tape contains: 
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File Tape File Name 



1 . None 



TAPE. UPDATE 



3. TAPE.ASMMAC 



4. TAPE.A3MNDX 



TAPE.SYSMAC 



TAPE.MACNDX 



TAPE.GENMAC 



8. T^PE.GENNDX 



| 9. TAPE.UTLMAC 



| 10, TAPE.UTLNDX 



1 11. TAPE.SYSIAM 



| 12. TAPE. STARTUP 



| 13. TAPE.SYSUTL 



| 14. TAPE. PRELUDE 



1 15. TAPE.SYSIVM 



| 16. TAPE.RESSUP 



1 17. TAPE.RSSSUP 



I 18. TAPE. SYSLIB 



Public/Private 

Name 

TSS source 

modules 



SCRIPT. UPDATE 

ASMMAC(+1) 
ASMNDXC+1) 
3YSMACC+1) 



Purpose 



A copy of the source modules 
(in SYSIMO format) modified 
for this release. 

An executable script of neces- 
sary commands to cause the 
update to be applied. 

A replacement for ASMMAC macro 
instructions. 

A replacement for the ASMMAC 
macro index. 

A replacement for the SY3MAC 
macro instructions. 



MACNDXC+1) A replacement for the SYSMAC 
macro index. 



GENMACC+1) 
GENNDXC+1) 
UTLiMACUl) 
UTLNDX(+1) 
UPDATE. SYSIAM 

UPDATE. STARTUP 
UPDATE. SYSUTL 

UPDATE. PRELUDE 



I VM9 9. CHANGES 
SUP9 9. CHANGES 
RSS9 9. CHANGES 
UPDATE. SYSLIB 



A replacement for GENMAC macro 
instructions . 

A replacement for the GENMAC 
macro index. 

A replacement for UTLMAC macro 
instructions. 

A replacement for UTLMAC macro 
index. 

A VPAM data set containing the 
replacement module for the in- 
dependent access method. 

A VPAM data set containing the 
replacement module for STARTUP 

A VPAM data set containing the 
replacement modules for the 
independent utilities (includ- 
ing UTLMAC when applicable) . 

A VPAM data set containing the 
replacement module for PRE- 
LUDE. The control section for 
PRELUDE may be moved to the 
IPL volume by RSS. 

A VPAM data set containing the 
replacement modules for SYSIVM 

A VPAM data set containing the 
replacement modules for RESSUP 

A VPAM data set containing the 
replacement modules for RSSSUP 

A VPAM data set containing the 
replacement modules for SYSLIB 
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i 19. 



TAPE. SYSERP 



UPDATE. SYSERP 



A VPAM data set containing the 
replacement modules for SYSERP 
(including ERPMAC when 
: ipplicanl e} . 
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TAPE . U PDATE . ASMMAC UPDATE . ASMMAC 



A copy of the replacement 
regions for ASMMAC macro 
instructions . 



| 21. TAPE. UPDATE. SYSMAC UPDATE . SYSMAC A copy of the replacement 

regions for SYSrfAC macro 
instructions * 



22. TAPE. UPDATE. GENMAC UPDATE. GENMAC A copy of the replacement 

regions for GENMAC macro 



I 23. 



TAPE . UPDATE . UTLMAC UPDATE . UTLMAC 



A copy of :-.he ^placement 

if*g..ioiis l\j; UTLMAC macro 
i n:stru:.:t i o>;s . 



I m. 



TAPE.VSSLIB 



UPDATE. VSGhiB 



A /1'AM dat \ sot. containing the 
un- 1 inkenl r; ed. V SS r emplacement 

modules . 



1 25. 



TAPE.FORLIB 



UPDATE. FORLIB 



A VPAM data set containing the 
un- linked! ted FORTRAN replace- 
ment modules. 



26. 



TAPE.APGEN 



APGEN 



A replacement for the APGEv 

data set. 



| 27. 



TAPE.VSSLINK 



SCRIPT. VSSLINK An executable script of com- 
mands for the ..linkage edit of 
VSS. 



1 28. TAPE.FORLINK 



SCRIPT, FORTRAN 



An executable script of com- 
mands for the linkage edit of 
FORTRAN - 



29. 



TAPE. PPLI .xxxxxxxx SCRIPT. PPLI . 

xxxxxxxx 



An executable script of 
commands for the installation 

of irarqr^m products for the 
program product language 
interface., 



1 30. TAPE. UPDATES 



UPDATE .MODULE 



A region data set containing 
modifications that were made 
to the source modules for this 

release. 



When there are data sets that have no change and thus are not included 
on the maintenance release tape, each file will move ahead to keep the 
file numbers sequential. (For example, if TAPE. SYSMAC r TAPE.MACNDX 
TAPE.GENMAC lf TAPE.UTLMAC f TAPE. UTLNDX # and TAPE.GENNDX were omitted, 
then TAPE.SYSIAM would be file number 5.) 

The change tape script assumes that the change tape is 16 00 bpi and that 
the IPL volume is TSSRES. If your tape is not 1600 bpi or if your IPL 
volume has a different volume ID, the script must be modified before it 
is executed., 
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SECTION 3: UPDATE STRUCTURE 



Tne maintenance release script (file 2) is divided into four logical 
parts: part 1, which performs a tape-to- VAM copy of all modified macro 
libraries, module libraries, and executable scripts? part 2 f which 
reviews all VAM data sets created by the tape-to-VAMs; part 3, which 
catalogs macro libraries as generation+1 and copies the changed modules 
to tne appropriate system data sets; and part 4, which modifies the SYS- 
PRO, SYSMLF, SYSPRD, and SYSPRX members of SYSLIB when applicable. 

Parts 1 and 2 perform the setup of the changes and do not impact a 
running system, except for the external storage required and any new 
macro instructions introduced in part 1. Parts 3 and 4 perform the ac- 
tual update to bring the system up to the release level. This logical 
structure gives you the flexibility of running the update as one script 
(see Appendix H, Figure 9) , or of using the Text Editor to divide the 
script into two or more sections (see Appendix H r Figure 10) or running 
a 3YSGEN assembly, and introducing user macro instructions, or inspect- 
ing changes on a section to section basis. 



SECTION 4: MAINTENANCE PROCEDURES 



Tne procedure to be followed by the installation when updating the 
system is described below (s e also Figure 5). Appendix ri, "Sample 
Maintenance Procedures," contains typical command sequences to be 
entered from a terminal, as well as sample update scripts. The detailed 
procedure and descriptive information associated witn a specific mainte- 
nance release are provided oy the SCRIPT. UPDATE data set that is read in 
from the change tape. The procedure is as follows: 

1. IPL trie new DASDI utility from the independent utility tape and 
create an IPL volume with a volume identification of QSSIPL. Note: 
This is required only if CEIAP (Prelude) has changed in this main- 
tenance release. 

2. Start up your latest TSS system. Recommendation: Prior to execu- 
tion of a maintenance update, any direct access storage containing 
system data sets that are affected by the update should be saved on 
tape by the DASDDR utility. It is advisable for the user to have a 
reasonably recent back-up tape for his currently running system. 

3. The system programmer (userid TSS), as the owner of all data sets 
on the change tape as well as of the system data sets, must bring 
in and execute the update script. (See Appendix H, Figure 9.) 

4. When the update process is complete, the operator should shut down 
the system and then save all changed volumes using the DASDDR 
utility. 

5. If prelude has been altered in this release, it will be necessary 
to do a disk-to-disk save of your new IPL volume to the QSSIPL vol- 
ume created in step 1 of this procedure, using the DASDDR utility. 
Note: Steps 1 and 5 should be skipped if there has been no change 
to Prelude. 
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I 

j STARTUP new TSS | 

L J 



Figure 5. System Maintenance Release 
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PART V: DYNAMIC MODIFICATION OF THE SYSTEM 



SECTION 1: OVERVIEW 



Dynamic modification is the process of testing the effects of changes 
to the system without permanently updating the system. The changes may 
be either from IBM-supplied maintenance packages or user-initiated modi- 
fications. The changes, which remain in effect from startup until shut- 
downy are contained in delta data sets and must be on one private or 
public volume (delta data set volume), described in Section 2. 

During the startup procedure, delta data sets are searched for ini- 
tial virtual storage, resident supervisor, and resident support system 
control sections; then, system data sets on the I PL volume are searched. 
After the system* s query "DELTA DATA SETS?", the order of search for 
these data sets is specified by the operator. 

There are three load lists: one each for the resident supervisor, 
initial virtual storage, and resident support system. Only the control 
sections that are identified by name in a loadlist are loaded. Since 
these load lists are control sections and are located by STARTUP in the 
same manner as any other control section, an alternate load list, from 
that contained in the system data sets, can be included in a delta data 
set. Such a load list might be used to add control sections to initial 
virtual storage, the resident supervisor, or the resident support system 
(see the description of the LLIST macro instruction in System Program- 
mer's Guide) . Tasks executed during the current session will run with 
all such modifications to initial virtual storage, the resident supervi- 
sor, and the resident support system. To permanently modify the system, 
the same delta data sets that changed the system during the startup pro- 
cedure may be incorporated by the system maintenance process (described 
in Part TV). 

SECTION 2: DELTA DATA SETS 



Delta data sets are used at startup time to dynamically modify the 
contents of initial virtual storage, the resident supervisor, and the 
resident support system. A delta data set: 

1. Has VPAM organization. 

2„ Requires the use of a private or public direct access device. 

3« Is on a volume that has a known serial number (one volume must con- 
tain all the delta data sets used in a single startup session) . 

4. Has a dsname with a second-order qualification of IVMnn r SUPnn, or 
RSSnn (nn = integer from 00 to 99) r depending upon whether the data 
set contains SYSIVM, RESSUP, or RSSSUP modules. The first-order 
qualification of the data set name is the eight-character user i- 
dentif ication that the systen automatically prefixes to data set 
names. At join-time, fewer than eight characters may be specified 
for a user identification; asterisks are then appended to extend 
the identification in the data set naire to eight characters. The 
complete data set name, including the user identification, is re- 
stricted to 44 characters. 
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To construct such a delta data set, use the DDEF command to define 
the data set as a JOBLIB and describe its characteristics to the system. 
Then using the TSS Assembler, create object modules for inclusion in the 
data set so that each object module becomes a member of the partitioned 
delta data set. All future assembled modules will be stored in this 
data set until another DDEF command with OPTION=JOBLI3 is issued or un- 
til the user logs off. 

Example: Build a data set named USERID1*. IVM01. ZZ on a private vol- 
ume that has serial number 222222. This terminal session might occur: 

SYSTEM : (keyboard unlocks) 

USER : logon us eridl, password 

SYSTEM : TASKID=00E4 LOGON AT 13:56 ON 09/15/76 

USER : ddef ivm, vp, dsname=ivra01. zz,unit~ (da, 3330) , 

volume=C ,222222) ,option= joblib,disp=new 

assemble object modules for this data set 

logoff 

The changes to the SYSIVM r RESSUP, and RSSSUP data sets that are sup- 
plied in an IBM maintenance package may be made into delta data sets by 
properly naming .and placing the object module libraries. The changes 
may then be tested prior to a permanent system update. 



SECTION 3: DYNAMIC MODIFICATION PROCEDURE 



STARTUP first asks the operator for the codes of those functions not 
to be loaded. Any function or module that can be omitted from the load 
has a code in the load list entry; codes 01 through BF are reserved for 
the system, codes CO through FF are reserved for the user (see System 
Programmers Guide ). If modules are to be excluded from the load at 
STARTUP, the operator may enter the codes at the terminal or via the 
card reader. If no codes are entered (no modules are to be excluded) , 
an EOB is entered at the terminal or a blank card or an END card is 
entered at the card reader. 

STARTUP next asks the operator whether dynamic modification of SYS- 
IVM, RESSUP, or RSSSUP is wanted: DELTA DATA SETS? Y OR N. If the 
system is not to be modified, the operator types N; STARTUP proceeds to 
load SYSIVM, RESSUP, and RSSSUP from the system data sets on the IPL 
volume (see Figure 6). When he types Y r he receives a message request- 
ing the device address and data set specification for the delta data set 
volume. He answers this request in this format: 

xxx x , dsname,... 

where 

1. xxxx is the three- or four-character hardware address of the device 
on which the delta data set volume has been mounted prior to run- 
ning STARTUP; 

2„ dsname specifies the data set name (either fully or partially qual- 
ified) of a delta data set that is to be searched prior to search- 
ing the system data sets. 
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3„ An EOB is entered at the terminal or an EM) card is entered at the 
card reader to terminate the list. 

If a specific number of data sets is to be searched, the order in 
which the data set names are specified by the system operator is the 
order in which STARTUP will search. Each data set name must be speci- 
fied with its complete user identification (including any asterisks). 
If all the data sets identified by a partially qualified data set name 
are to be searched in the order in which they are found on the volume, 
only the partially qualified data set name need be entered at the con- 
sole by the system operator. 

When STARTUP has all the delta data set information, it loads the in- 
itial virtual storage, the resident supervisor, and the resident support 
system as specified. If minor errors occur, a message is sent to the 
the operator and processing continues. See Appendix I for an example of 
a terminal session of dynamic modification. 

The operator may cancel any invalid information he has entered and 
then reenter the correct information. To avoid reentering the series 
when one data set name in a series is incorrectly specified, the opera- 
tor may continue the list with the correct data set name; the incorrect 
entry receives a diagnostic message and is bypassed. If a specific 
dataset name cannot be found on the delta volume, the data set is 
ignored and the operator is notified. 
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DATA SETS j 
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DATA \ 



r * 1 

| STARTUP loads CSECl's | 

— \ in SYSIVM, RESSUP S | 

| RSSSUP from IPL Vol j 

i __. J 



| STARTUP searches delta volume 1 

~| & then IPL volume for CSECTs;| 

[ continues processing j 

L „_ T J 



^ 



r * 1 

1 STARTUP COMPLETE | 
L r J 



1 TSS is operational | 

L ,_ J 



| SHUTDOWN | 
| end of effect of | 
| delta data sets | 

L i 



Figure 6. Dynamic Modification Procedure 
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APPENDIX A: MACRO INSTRUCTION FORMATS 



1. Symbolic Mnemonics used in Macro Instructions 

symbol - string of one-to-eight alphameric characters; the first 

must be alphabetic. (In TSS the alphabetic characters are **/_, 
$ r #, and 3; the alphameric are the alphabetic plus 0-9.) 

operand name - single word, ' usually mnemonic; tells what the 

operand represents. 

coded value - string of characters written exactly as shown (num- 
bers or uppercase letters) . 

value mnemonic - single mnemonic that summarizes a variety of 

values that can be specified for the operands. from the set of 

values identified* the user chooses one and writes that value. 
The value mnemonics used are: 

alphnum - string of alphameric characters; the first need not 
be alphabetic. The limit on the number of characters is given 
under the macro instruction. 

>. de - set of specific values, one of which is written; shown 
explicitly in format illustration if there are three or fewer; 
or m co&e n appears in format and the actual values in the text, 

hexinteger - hexadecimal number; the limit of the number of 
digits is given under the macro instruction. 

integer - decimal number; the limit of the number of digits is 
given under the macro instruction. 

2. Configuration Macro Instructions 

r ... T __ — _„_____„__ — ______ — _____ — .___ . — _ — . . 1 

(Name | Operation [Operand I 

H _ — ^„ + „_„„__ + „„„„„, „__„„„________„_„„. — .„ H 

j (symbol J j CHANNEL | CPU= (0 1 1 .} f MPX= (hexinteger , . . . ) | 

J | | [ f SEL= (hexinteger, ... )] [ r BMX= (hexinteger ),... ] j 

l_ . ,___x__ . ,_jl . _. — . .. _. ___ -_. ___J 

r __. — . — „ T — ._ ___ T — ._ — __. .___„_ ___ — „_____ — „__„ . — . _ 1 

(Name J Operation (Operand | 

l_- +-____+-—---—- ______ ._„________ H 

| [symbol] (CPU |nocpu~C112} | 

L__. ______ .„__JL____ . ._ >______- . ___________ . _J 

f _ ._ .______. _______ — . — _. „___. ___. _______ — __ . _. . 1 

(Name | Operation (Operand | 

H _„___ + „„__ + ___ _ -_-_____„„________{ 

| cuname |DCU I UNIT=code,PATH= (hexinteger~-hexinteger # . . . ) | 

| j j | [ # MODEL=£l|2|3|4|5| 6|7|8>] I^SHARED=C Y| N} J | 

L____. __________ A_, - _ _______ ._ „________- — _______ .____ J 
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I Name 



h 



| Operation | Operand 



[gpname | DEVGRP 



j UNIT-code , PATH= C ( cuname f hexinteger ) , . . 
, ADDRESS=( (hexinteger, hexinteger) , . . . ) 
[, MODELS code) 
[,FEATURE=(code, . . . )] 
[,MAXIO= integer] 
[ , TYPE= { RESERVED | AS YNCB } ] 
[,I0REQ=[YES|N0}3 
[,CONTRL={2701|2702| 2703}] 
[,HOLD={Y|NH [,DDSDA=[Y|N>] 
[,ABUF=integer] [,DCM=integer] 



r - y .__ — T 

| Name ( Operation | Operand 



I h 

| j [symbol] | OPCNSL 

L ._. .___X .. . 



| (SDA[, ALARM, RSS,RMS,SYSMSG,HRDCPY,SYSERR] ), . . . 

„X_ ... . . ,__ . . . 



r - ._ T « — . . T . — . 

| Name | Operation | Operand 



| [symbol] | ST.EM 

L , . J. ._- 



I number-integer , sup- integer 



3. Task Management and Command System Macro Instructions 



„ T ^ — . T ._ 

| Operation j Operand 



1 Name 



k 

j [symbol] |CLOP 

I 1 
I i 



I 1 
I I 



|PRMTLMT= integer 

I ,PRVLG= (code, . . . ) , AUTH=CU ( P> 

| [,DSORG=code],DATYPE={ 2311 | 2314 | 3330 |333B| 3350} 
1 | , TATYPE= { 7 | 7DC | 9Dn } , DEN= { 1 1 1 2 I 3 | 4 } 

| | [,LABTYP=[NL|SUL|SL}] 

j j , DAPAGES= (integer 3 - , integer 2 ) 

| j ,DACYLS= (integer*, integer 2 ) 

| | , DATRKS= integer 

j | ,LIBPGS= (integer*, integer 2 > 

j | [,CFM=alphnum] [ f PFM=alphnum] 

| | [,MAV=integer] [,PRIO=integer] 



I Name 



h 



j Operation j Operand 



| 1 [symbol] |DISPAR 1IXT=( integer*, integer 2 ) 

| [,LDMTR= integer] [,PURGSH=integer] 
| [,THRESH=integer] [,BUFSIZ= integer] 
| [,AUXSP= (integer*, integer 2 )] 
| [,INITLVL=integer] [,TCR=integer] 
| [,BLKSZE= (integer*, integer 2 )] 
x . 



I 
1 I 



I 



(Name j Operation (Operand 

h + + _ 

| [ symbol ] | PUBVOL j MAXVOL= integer 

L___ .X - J 
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r . T _ T — . . — . — . — _. . 1 

(Name | Operation [Operand | 

j. ._„+„_ + _. __ . . . _ | 

I [symbol] | TSKLMT | CONV=integer ,MTTM)M=integer r BATCH=integer 1 

| | | ,BACK=integer f PGTBL=integer | 

| | | [,P3LMT= integer] | 

| | | l r OVRAUX^integer] [ ,RTAM3UF=integer 3 | 

L _. JL ._„ „_X . .__ . - __ _. . . _. . J 

r „ T — -. __ T _- „. „__„- — . ___. „ — . 1 

| Name | Operation | Operand I 

t „_„„ + „— „„+_— _- — — — j 

1 [symbol] | VMPAR j [VCSLNG= {integer |SEGMEwT> ] r SDST=integer | 

| j | [ f OPTION S=( code, . . . ) ] [ r TIME=integer] | 

L . JL— -_____„ JL__—. . ._ - — .— ._„ . . - . __. J 

4. System Table Generation Macro Instruction 

r _„ T . T - — — .—_. . — . . — ._ — .- _ . — . • 1 

[Name [ Operation | Operand | 

K _„„_ + __„__ + _„__-_--. „— „_„„ „_ ._ H 

1 [symbol] [GENSCB | | 

L_ . _JL . ± .___ . „ . . .__ . J 
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APPENDIX B: STRUCTURE OF TSSRES 



The system data sets required for starting up and running TSS are 
stored initially on one volume, TSSRES CTSS resident volume). All these 
datasets, except SYSLOG (the system operator log), SYSBWQ (the system 
operator's work queue), and USERLlBs for SYSMANGR and SYSOPERO, are 
cataloged under the userid TSS***** r with a password of IBM. 

The major system data sets, shown in Figure 7 , that reside on TSSRES 
are: 

TSS***** . SYSCCB (system configuration control block) is a generation 
data group in which each VPAM data set contains a description of t he- 
system configuration. SYSCCB, created at system generation time, is 
used oy STARTUP to acquire such information as: (1) paths to prin- 
ters; (2) number of central processing units; and (3) number of pages 
in real storage. 

TSS*****. STARTUP (system STARTUP module) is a generation data group 
in which each VPAM data set contains one member — the STARTUP module 
(CEIAA) . STARTUP initiates the Time Sharing System. STARTUP is 
called by performing an initial program load (IPL) of the TSSRES vol- 
ume. The IPL process reads in PRELUDE which, after initial process- 
ing, reads in the independent access method and STARTUP. Control is 
then passed by the independent access method to START Ur to continue 
the Time Sharing System. 

TSS***** . SYSIAM. DSTSSRES is a VPAM data set which contains one member 
— the independent access method module (CEIAM). IAJM is the input/ 
output interface that is used by STARTUP and the independent utili- 
ties. If a quick start data set is built at startup time, a copy of 
CEIAM is moved to the quick start volume and given the name TSS*****. 
SYSIAM. DSxxxxxx, where xxxxxx is the volume ID of the quick start 
volume . 

TSS*****.RESSUP (system resident supervisor) is a generation data 
group in which each VPAM data set contains the modules of TSS rou- 
tines that permanently reside in main storage. Control sections from 
these modules are link-loaded, by STARTUP, into available main stor- 
age. The presence of these control sections in this data set is a 
necessary but not sufficient condition for such link-loading; STARTUP 
will load only those control sections whose names are included in a 
special list found in RESSUP. 

TSS*****.SYSIVM (system initial virtual storage) is a generation data 
group in which each VPAM data set contains the system modules that 
are automatically provided for each user at task- initiation time. 
The presence of these control sections in this data set is a neces- 
sary but not sufficient condition for such link-loading; STARTUP will 
load only those control sections whose names are included in a spe- 
cial list found in SYSIVM. 

TSS*****.RSSSUP (resident support system) is a generation data group 
in which each VPAM data set contains the modules of Time Sharing Sup- 
port System (TSSS) routines that reside in main storage during TSSS 
execution. Control sections from these modules are link-loaded, by 
STARTUP, into a virtual storage which will be mapped into main stor- 
age during TSSS execution. The presence of these control sections in 
this datci set is a necessary but not sufficient condition for such 
link- loading; Startup will load only those control sections whose 
names are included in a special list found in RSSSUP. 
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TSS*****.SYSUTL (independent utility library) is a generation data 
group in which each VPAM data set contains the modules of the inde- 
pendent utilities. Control sections from these modules are read into 
main storage oy the independent access method (IAM) , which in turn 
was read in by PRELUDE. The presence of control sections in this 
data set is a necessary but not sufficient condition for loading by 
IAM; IAM will load only those control sections that are specifically 
required for the STARTUP process or the independent utilities. 

TSS*****.SYSLIb (system library) is a generation data group in which 
eacn VPAM data set is a collection of modules that are automatically 
eligible for loading into each user's virtual storage by the dynamic 
loader- SYSLIB contains virtual storage system modules not found in 
SYSIVM- Also contained in SYSLIB are: SYSPRO (system procedure li- 
brary), SYSPRX (system prototype profile), SYSPRD (system procedure 
dictionary), and SYSMLt (system message file). 

TSS*****.SYSSVCT (user catalog index) is a VI3AM data set that has a 
user identification code for each user joined to the system. This 
data set also contains pointers to each user catalog (USERCAT) in the 
system. New user identification codes, along with their correspond- 
ing USERCATs, are added to SYSSVCT by the JOIN command and removed by 
the QUIT command. SYSSVCT initially has three user identification 
codes: SY6OPER0, SYSMANGR, and TSS*****. 

TSS* * * * * . S YSCaT (system catalog) is a VPAM data set that contains as 
members copies of USERCATs for all users that have logged on during 
one TSS session. The system catalog is purged of USERCATs at shut- 
down time. SYSCAT is initially a null data set. 

TSS* * * * * . USERCAT (user catalog) is a VSAM data set that contains 
pointers for each cataloged data set owned by TSS*****. This data 
set also contains information on ownership and sharing privileges for 
shareu data sets. USERCATs are created by the JOIN command and 
deleted by the QUIT command. Entries in a user's catalog are main- 
tained by the CATALOG r DELETE, ERASE, PERMIT, SHARE, DDEF, RC, and RT 
commands , 

TSS*****. SYS MA C (system macro library) is a generation data group in 
which each VI SAM region aata set contains definitions of all macro 
instructions necessary to support normal nonpriviieged user 
assemolies. 

TSS*****. MACNDX (system macro library index) is a generation data 
group in whicn each VSAM data set is an index to the system macro 
library. 

TSS***** . A SMMaC (system assembler macro library) is a generation data 
group in which each VISAw region aata set contains definitions of TSS 
macro instructions, used in: system generation, on-line test system 
(OLTS) , assembling both FORTRAN and the sapervisor (those not in SYS- 
MrtC) , and the system DSiCTs. 

TSS***** . A3MND X (system assembler macro library index) is a genera- 
tion data group in which each VSAM data set is an inde^ to tne system 
assembler macro librarv. 

TS S ***** . GE NtaAC (system generation macro library) is a generation 
data group in which each VISAM region data set contain^ definitions 
of TSS macro instructions usee specifically for system generation. 
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TSS* * * * * . GENNDX (system generation macro library index) is a genera- 
tion data group in which each VSAM data set is an index to the system 
generation macro library. 

TSS* * * ♦* . UTLMAC (utility macro library) is a generation data group in 
which each VI SAM region data set contains definitions of TSS macro 
instructions used specifically for independent programs (CEI) and 
utility programs (CEB) . 

TS S * ♦ * ♦ * . UTL NDX (utility macro library index) is a generation data 
group in which each VSAM data set is an index to the utiltiy macro 
library. 

TSS***** . SYSERP (error recording edit and print library) is a genera- 
tion data group in which each VPAM data set contains the modules nec- 
essary to run VMEREP; this data set also contains ERPMAC, the macro 
library necjded to assemble the EREP modules. 

TSS*****.SYSUSE (system user table) is a VISAM data set that has one 
entry for each currently authorized user of the system. Each user's 
entry contains his identity, password, charge number, job priority, 
command-set privilege, and authorization attributes. The entries are 
in user-identity sequence and are variable in length to a maximum of 
256 bytes. SYSUSE initially contains entries for the system opera- 
tor, the system manager, and the system programmer (userid TSS). The 
data set is maintained by the system administrator. Entries are 
added by the JOIN command and removed by the QUIT command. 

TSS* * * * * . USERLIB (user library) is a VPAM data set that i:> opened and 
placed on the JOBLIB chain when TSS logs on. This data set is ini- 
tially empty. 

TSS*****. SOURCE. SYSGEN (sample system generation source) is a VISAM 
data set that contains a sample multi-processor SYSGEN. 

TSS* ♦***. SYSGEN. MODULE (sample system generation module) is a VPAM 
data set that contains the object module created by assembling 
SOURCE. SYSGEN. 

TSS*****.APGEN (apply the system generation module) is a VISAM data 
set containing the command system and linkage editor control state- 
ments that apply the system generation object module to TSS. 

TSS*****.FQRLIB (FORTRAN library) is a VPAM data set that contains 
the un-linkedited object modules for the TSS FORTRAN compiler and tne 
TSS FORTRAN run time library. 

TSS***** , SCRIPT. FORTRAN (FORTRAN linkedit script) is a VISAM data set 
that contains the executable script to perform the linkage edit for 
the TSS FORTRAN compiler and run time library. 

TSS*****«VSSLIB (virtual support system library) is a VPAM data set 
that contains the un- link edited object modules for the virtual sup- 
port system (VSS). 

TSS***** . SCRIPT. VSSLINK (VSS linkedit script) is a VISAM data set 
that contains the executable script to perform the linkage edit for 
the virtual support system (VSS) . 

TSS*****. SCRIPT. PPLI . xxxxxxxx (program product installation scripts) 
is a set of VISAM data sets that contain the executable scripts nec- 
essary for the installation of certain program products. The 
xxxxxxxx is a name describing the particular program product to which 
the script applies. 
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SYSMANGR . USERCAT (user catalog) is a VSAM data set that contains 
pointers, sharing privileges, and ownership information for each data 
set cataloged for SYSMANGR. 

SYSMANGR. USERL1B (user library) is a VRAM data set that is opened and 
placed on the JOBLIB chain when SYSMANGR logs on. This data set is 
initially empty. 

SYS Q PERO . USERCAT (user catalog) is a VSAM data set that contains 
pointers, sharing privileges, and ownership information for each data 
set cataloged for SYSGPERO. 

SYSQPERO . U8ERLIB (user library) is a VPAM data set that is opened and 
placed on the JOBLIB chain when SYSOPER0 logs on. This data set is 
initially empty. 

SYSQPE R O . SYSLQG (system log) is a generation data group in which each 
VISAM data set contains a record of all communication between the 
system and the operator. A print is issued for the current SYSLQG 
data set when TSS is shut down. A new SYSLQG data set is created 
when TSS is started up. 

SYSQPERO . SYSBWg (batch work queue) is a VISAM data set that contains 
a queue of work for the batch monitor and/or the BULKIO task. 
Entries are placed on the batch work queue by the PRINT and EXECUTE 
commands. Entries are removed from the batch work queue by the batch 
monitor. 
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CYL. 0, TRK.O 



CYL. 0, TRK. 1, RFC. 



[SS*****.SYSCCB 
.STARTUP 

. SYS I AM . DSTSSRES 
-RESSUP 
-SYSIVM 
.RSSSUP 
.SYSUTL 
-SYSLIB 
.SYSSVCT 
-SYS CAT 
-USER CAT 
-SYSWRC 
-MACNDC 
- ASMkAC 
. ftSMNDX 
.GENMAC 
.GENNDX 

• UTJLMAC 
. UTLNDX 
.SYSERP 
.SYSUSE 
.USERLIB 

. SOURCE. SYSGF.N 
-SYSGEN -MODULE 
.APGEN 
-FORLIB 

.SCRIPT. FORTRAN 
.VSSLIB 

• SCRIPT. VSSL INK 
.SCRIPT. PPL I 



3YSMAUGR. USERCAT 
•USERLI3 



SYSOPER0.. USERCAT 

..USERLIR 

..SYSLOG 

.SYS3WQ 



Public Storaae 



| Record 1; 24~byte IPI Bootstrap 

<— < Record 2: 144-byte IPL Program 

| Record 3: 80-byte Volume label 

L 



< PRELUDE 



Data sets for prejoined 
system programmer 



<■ Data sets for system manager 



< Data sets for system operator 



< — - Balance cf Pack Available for 

Public storage 



Figure 7. TSS Resident Volume CTSSRES) 
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APPENDIX C: 



THE SYSIMO PROGRAM 



The purpose of the SYSIMO program is to read a specially formatted 
and blocked BSAM tape file and create multiple VISAM source data sets. 

The program is invoked by the commands 

CALL SYSIMO 

The user is then prompted for information by three messages; 



VOLUME=C f volserno) 

where volserno is the volume serial number of a nine 

track, non-labeled, default density tape. 

DDNAME=ddname 

where ddnanie is the data definition name previously 
assigned to the tape. 
j. _ _ _._______„__._„„_._„. 



message: 
response: 

response: 



SPECIFY INPUT TAPE 



VOLUtfE=( )/DDNAME= 



message: 
response: 

response: 
response: 



SPECIFY DATA SET SELECTION 



ALL 



response: 



response; 



response: 



response: 



all data sets on tape are to be copied to disk. 

SCAN 

all data set names on tape are to be listed, no copy 
is done. 

dsname, dsname , • . . 

a selected set of data sets are to be copied to disk. 

The set of data set names may be continued to 

multiple- lines by typing a dash n - n immediately 
following the last dsname on a line. 

dsname, ETC 

all data sets from dsname on are to be .copied to disk. 

dsname, ETC, SCAN 

all data set names from dsname on are to be listed. 
No copy is done. 

dsname f dsname , INC 

all data sets between the two dsnaraes, inclusively, 
are to be copied to disk- The first dsname should 
precede the second on the tape. 

dsname f dsname , INC, SCAN 

all data set names between the two dsnaroes , inclusively, 

are to be listed. No copy is done* 



-I 



message: SPECIFY OUTPUT DISK — VOLUME= < ) ,TYPE= /PUB 

response: VOLUME- (, volserno) ,TYPE=direct access type 

where volserno is the volume serial number of the disk 
that is to contain the source data sets, and direct 
access type is either 2311, 2314, 3330, 333B, or 3350. 
If VOLUME is specified and TYPE is omitted, 3330 is 
assumed. 

response: PUB 

the source data sets are copied to public storage. 
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APPENDIX E: TSS STARTER SYSTEM 



The TSS starter system machine configuration is shown in Figure 8. 
The macro instructions needed to generate this configuration are in Ap- 
pendix E. A description of the symbolic device address assignment is in 
Appendix F. 

A minimum machine configuration may be formed from a subset of the 
starter system hardware addresses. Once TSS is operational on such a 
minimum machine configuration, a SYSGEN that describes your particular 
hardware configuration may be performed. 
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Figure 8- (Part 1 of 2) TSS Starter System Machine Configuration 
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Figure 3. (Part 2 of 2) TSS Starter System Machine Configuration 
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APPENDIX E: STARTER SYSTEM SYA^FN ^ACHO INSTRUCTIONS 



These system generation macro xipit^jCLlon:*. vcp'it^ 
chine configuration shown in Figure 8 CAoreirUx P) . 
structions is contained on the TSSRES yniiuii ••.\fuier M> 
TSS*****. SOURCE. SYSGEN. 



\a starter TSS ma- 
copy of these in- 



SYSGEX 
* 

* 



* 




* 




* 




DSPOO 


DCU 


DSP01 


DCU 


* 




OPR00 


DCU 


OPR01 


DCU 


* 




* 




* 




JRtoOO 


DCU 


DRW 01 


DCU 


* 




DRM 02 


DCU 


DRM03 


DCU 


* 




* 




* 




DSK00 


DCU 


D3K01 


DCU 


DSK02 


DCU 


* 




DSK03 


DCU 


DSK04 


DCU 


DSK05 


DCU 


* 




DSK06 


DCU 


DSK07 


DCU 


DSK08 


DCU 


* 




DSK09 


DCU 


DSK10 


DCU 


DSK11 


DCU 


* 




DSK12 


DCU 


DSK13 


DCU 


DSX14 


DCU 


* 




DSK15 


DCU 


DSK16 


DCU 


DSK17 


DCU 



TITLE •TSS/370 STARTED AYATEfM (• PAPPAT ION * 

STAR1 

CPU 2 

STEM 20tl8 r 512 

CHANNEL CPU=0 r MPX=- ( ) , BMX- ' ( 1 # 2 , '* , l -\ , ~ > 6 ) 
CHANNEL CPU=1 f ttPX- ( ) , RMX-- C 1 , / t \ , h , .'. , f. ) 

OPERATOR Df.VlCP tUNTIojt PPPA' 



UN1T=306 6 f PAT H== (0040- 4 , 1 n P ! Mi ) 
UNIT==3066 f PATH==U0M)--*>0, OOmP- p') ) 

UNIT=105 2 # F»ODEI.A-7 f P/PIh t OiA-l '; M »('**■ 
UNIT=1052 r MOi.)FI,-7,rA'ItI * MM **"• > i- . i::.» i >' - 

DRUM CONTROL UK'Fui 

UNIT=28 3 5,KOUEE--2,PATh " (Uh"0-i7, ] ICA;- 

UNTT=2835,M)DEJp ,;\ PaTA ( 0TD0-- ; • "' „ 1 UPA- 



UNlT=28 3 5 r MODEL-^2 f PA'hA « 1 .A Pi 
UNIT=2835' f f«jODEL-^2 f PATH- f i 2i 0- 



/ , „ 



-c / > 

•Mi) 



DISK CONTROL UNITS 

UNIT=3830, MODELS f PATA-'-~ dsi f »P 
UNIT=3830,MODLL=.l » PATP - (0 1 «•() 
UNIT=3830,MODFL--1 , r^'Jn" ((.'I 7P 



UNIT=383Q,I*»OLjFL-1 f PA'Ai 
UNIT=3B30 , tiODF'.L- I r KVJ u " 
UNIT=3S30 f N:ODKr,- ! .. PA'H* 



■'J' , 1 J po- 
■oi- /I \ f.A?~ 

* M : vu- 

1 2P0 "P F ,. P -'•,••> " 
*' *PP ! '<P „ •.)/ f ■ 
1 7 ?i- 7 7,027 • 

, i A - U - 



UNIT=3830 ^iGiJEL-- "l , L'ATh-- # n.A,A«- m«" , 

UNTT=3830 r |.iODEL'"-l ? P l A*:ii C P U? :■ «,h , i .t 
UNIT=3830 ,iOuEL" 1 f PATn ( t s V/n / / . 1 ; A,.' 

UNIT=3830 f NiODEL-l , L-ATh ' < USi, - ; .F , U-. ..0 

UNIT-=3830 f MOi,EP--1 /» ATrJ-' Ci^bP ..F,U4<>v; 
UNIT=38 3 0,i-.Cl)KI.~t , P^Th" < U /u- 7 / , :.4V0 



UN1T~3830,KODEL-"'1 r l-/AAi-' i P vj ■ . i- r 1 -. A» 

UNIT=3830 f PiODElA"-l ,l : ATH~ ( 0560 - «>?-P • "-PIP 
UNXT=3830 r i-iOuFL-l , »V\Ti'=- COP'/p- .' '> , 1 F/ - 

UNIT=3fa30 r HODEL"--I,f , ATJr \lL,u- >« ,A;jU- 
UNIT=3fc3G,MODIiLA : 'l 9 PA'\.n~( i*.*^. 1 --: ^CboO- 

UNIT=--3830^ODEL--.l r PrPnj.-/ | <, /{; a, „ i;,P?0- 



7) 



7 ; i 
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TAP 00 
TAP01 
TAP 02 

TAP 03 

TAP04 

TAP 05 

* 

* 

* 

OR 00 

OR01 

TUOO 
TMOO 

TRMIPL 

* 

* 



TAPE CONTROL UNITS 

DCU UNIT=280 3,MODEL=1,PATH=(0180-8F,1180-8F) 
DCU UNIT=280 3,MODEL=1,PATH=(128 0-8F,02 8Q-8F) 
DCU UNIT=2b0 3,hODEL=l # PATH=(0 380-8F,138 0-8F> 

DCU UNIT=2803 f MODEL=l,PATH=(1480-8F # 04 8 0-8F) 
DCU UNIT=280 3,MODEL=l,PATH=(0 58 0-8F r 158 0-8F) 
DCU UWIT=280 3,MODEL=1,PATH=(16 8 0-8F,06 80-8F) 

UNIT RECORD CONTROL UNITS 

DCU UNIT=2821,MODEL=l,PATK=(00 0C-0E,100C-0E) 
DCU UNIT=2821,fcODEL=l,PATri=(101C-lE,001C-lE) 

TERMINAL CONTROL UNITS 

DCU UNIT=327 2 f MODEL=l,PATh=(000 0-0 7,1000-07) 
DCU UNIT-37 4 , MODEL=l , PATH= ( A0- AF , 1 AO-AP) 
DCU UNIT=3704,fcODEL=l,PATH=(0GB2-B2 , 3 OB?- 1 ^) 

OPERATOR DEVICE GROUPS 



DISPi^AYO DEVGRP UNIT=3066,TYPE=ASYNCH, IOREQ=YES f PATH= (DSPQO ,0 ) , 

ADDRESS= (0 , 24 0) , ABUF=64 , DCM=8 
DISPLAY1 DEVGRP UNIT=3066 ,TYPE=ASYNCH, IOREQ=YES,PATH= (DSP01 , ) , 

ADDRESS^ (0,260) , ABUF=64 ,DCM=8 



OPERO 
OPER1 
* 

DRUMOO 
DRUM01 
DRUM02 
DRUM 03 

* 

DISKOO 
DISK01 
DISK02 
DISK03 
DISK04 

DISK05 
DISK06 
DISK07 
DISK08 



DEVGRP UNIT=1050,MODEL=7,ABUF=64,DCM=4,PATH=(OPR00,0) , 

ADDRESS^ (0,209) 
DEVGRP UNI1=1050,MODEL=7,ABUF=64,DCM=4,PATH=(OPR01,0) , 

ADDRESS=(0, 21F) 

DRUM DEVICE GROUPS 

DEVGRP UNIT=230 5,MODEL=2,TYPE=PAGING,PATH=(DRM00,G), 

ADDRESS=(0,1) 
DEVGRP UNIT=2305,MODEL=2,TYPE=PAGING,PATH=(DRM01 f 0) , 

ADDRESS=(0,9) 
DEVGRP UNIT=230 5 r MODEL=2,TYPE=PAGING f PATH= (DRM02 ,0 ) r 

ADDRESS=(0,11) 
DEVGRP UNIT=23GS,MODEL=2 , TYPE=PAGING , PATH= (DRMQ3 ,0 ) , 

ADDRESS=(Q,19) 

DISK DEVICE GROUPS 

DEVGRP UNIT=3330 , IOREQ=YES , FEATURE- (TROFL) ,PATH= (DSKOO , ) , 

ADDRESS- ((0,40) ,(1,41), ( 2, 42) , (3 , 43) ) 
DEVGRP UNIT=333B,IOREQ=YES, FEATURE- (TROFL) ,PATH- (DSKOO ,8) , 

ADDRESS- ((0,48) , (1 ,49) , ( 2, 4A) , (3,4B) ) 
DEVGRP UNI T-3 3 3 0,IOREQ= YES, FEATURE- (TROFL) ,PATH= (DSK01 ,0) , 

ADDRESS- ((0,50), (1 , 51) , ( 2, 52) , (3,53) ) 
DEVGRP UNIT=333B,IOREQ=YES,FEATURE=(TROFL) ,PATH= (DSK01 , 8) , 

ADDRESS- ((0,58), (1 ,59) , ( 2, 5A) , (3, 5B) ) 
DEVGRP UNI T-3 3 5 0,IOREQ= YES, FEATURE- (TROFL) ,PATH= (DSK02 ,0> , 

ADDRESS=((0,60), (1 ,61) , ( 2, 62) , (3 , 63) ) 

DEVGRP UNIT-33 30, IOREQ-YES, FEATURE- (TROFL) , PATH= (DSK03 , 0) , 

ADDRESS=( (0,80), (1,81), (2, 82) , (3, 83) ) 
DEVGRP UNIT-333B, IOREQ-YES, FEATURE- (TROFL) ,PATH= (DSK03 , 8) , 

ADDRESS=( (0,88) , (1,89) , (2,8A) , (3,8B) ) 
DEVGRP UNIT-33 30, IOREQ-YES, FEATURE- (TROFL) ,PATH= (DSK04 , 0) , 

ADDRESS- ((0,90), (1,91), (2,92), (3,93)) 
DEVGRP UNIT-333B, IOREQ-YES, FEATURE- (TROFL) ,PATH= (DSK04 , 8) , 
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DISK09 

# 

DISK10 

DISK11 

DISK12 

DISK13 

DISK14 

* 
DISK15 

DISK16 

DISK17 

DISK18 

DISK19 

DISK20 
DISK21 
DISK 2 2 
DISK 2 3 
DISK24 

* 

DISK25 

DISK26 
DISK27 
DISK28 
DISK29 

* 

* 

TAPEOO 
TAPEOl 

* 
TAPE02 

TAPE03 

* 

TAPE04 

TAPE05 
* 



ADDRESS=( (0,98) , (1,99) , (2,9A), (3,9B)) 
DEVGRP UNIT=3350,IOREQ=YES,FEATURE= (TROFL) ,PATH= (DSK05 ,0) 
ADDRESS=( (0,A0) , (1 # A1) , (2, A2) , (3, A3) ) 



DEVGRP UNIT=33 

ADDRESS= 
DEVGRP UNIT=33 

ADDRESS= 
DEVGRP UNIT=33 

ADDRESS= 
DEVGRP UNIT=33 

ADDRESS= 
DEVGRP UNIT=33 

ADDRESS= 

DEVGRP UNIT=33 

ADDRESS= 
DEVGRP UNIT=33 

ADDRESS= 
DEVGRP UNIT=33 

ADDRESS= 
DEVGRP UNIT=33 

ADDRESS 
DEVGRP UN1T=33 

AODRESS= 



30 , IOREQ 
((0,C0), 
3B, IOREQ; 
((0,C8) , 
30, IOREQ: 
((0,D0) , 
3B r IOREQ; 
C(0,D8) , 
50,IOREQ : 
((0,E0) , 

30,IOREQ : 

((0,100) 

3B, IOREQ 

((0,108) 

30,lOREQ : 

((0,110) 

3B, IOREQ 

((0,118) 

50, IOREQ; 

((0,120) 



=YES r FEATURE= 
(1,C1), (2,C2) 
=YES,FEATURE= 
(1,C9),(2,CA) 
=YES,FEATURE= 
(1,D1), (2,D2) 
=YES,FEATURE= 
(1,D9), (2, DA) 
=YES,FEATURE= 
(1,E1), (2,E2> 



(TROFL) ,PATH= 
, (3,C3)) 
(TROFL) ,PATB= 
, (3,Cb)) 
(TROFL) f PATB= 
, (3,D3)) 
(TROFL) ,PATH= 
, (3,DIi)> 
(TROFL) ,PATH= 
,(3,F3)) 



DEVGRP UNIT=33 30 , IOREQ 

ADDRESS=( (0,140) 
DEVGRP UNIT=333B, IOREQ 

ADDRESS=( (0,148) 
DEVGRP UNIT=3330, IOREQ 

ADDRESS=( (0,150) 
DEVGRP UNIT=333B, IOREQ 

ADDRESS=( (0,158) 
DEVGRP UNIT=33 50, IOREQ 

ADDRESS=( (0,160) 



!=YES, FEATURE 
, (1,101) , (2, 
= YES, FEATURE^ 
, (1,109) , (2, 
=YES r FEATURE- 
, (1,111) , (2, 
= YES, FEATURE 
, (1,119) , (2, 
= YES, FEATURE 
, (1,121) ,(2, 

=YES, FEATURE 
, (1,141) ,(2, 
= YES, FEATURE 
,(1,149) ,(2, 
=YES, FEATURE- 
,(1,151) ,(2, 
= YES, FEATURE 1 
, (1,159), (2, 
=YES # FEATURE- 
, (1,161) , (2, 



,= (TROFL) 
102), (3, 
= (TROFL) 
10A),(3, 
= (TROFL) 
112), (3, 
,= (TROFL) 
11A) ,(3, 
= (TROFL) 
122) ,(3, 

= (TROFL) 
142), (3, 
= (TROFL) 

14A),(3, 
(TROFL) 

152), (3, 
= (TROFL) 
ISA), (3, 
= (TROFL) 

162), (3, 



DEVGRP UNIT=33 

ADDRESS= 
DEVGRP UNIT=33 

ADDRESS= 
DEVGRP UN1T=33 

ADDRESS= 
DEVGRP UNIT=33 

ADDRESS^ 
DEVGRP UNIT=33 

ADDRESS= 



30, IOREQ 
((0,180) 
3B, IOREQ 
((0,188) 
30, IOREQ 
((0,190) 
3B, IOREQ 
((0,198) 
50 , IOREQ 
((0,1A0) 



=YES, FEATURE 
, (1,181) , (2, 
=YES, FEATURE 
, (1,189) , (2, 
=YES, FEATURE: 
, (1,191) ,(2, 
=YES , FEATURE: 
, (1,199), (2, 
=YES, FEATURE: 
, (1,1A1) , (2, 



= (TROFL) 

182) r (3, 
(TROFL) 
18A) ,(3, 
=( TROFL) 
192) ,(3, 
(TROFL) 
19A), (3, 
=( TROFL) 
1A2) ,(3, 



, PATH= 

103)) 

,PATH= 

10B)) 

,PATH= 

113)) 

,PATH= 

11B)) 

,PATH= 

123)) 

,PATH= 

143)) 

f PATH= 

14B)) 

, PATH= 

153)) 

r PATH= 

15B)) 

,PATH= 

163)) 

, PATH= 

183)) 

, PATB= 

18B)) 

, PATH= 

193)) 

, PATH= 

19B)) 

,PATB= 

1A3>) 



(DSK06,0) 
= (DSK06,8) 
: (DSK07,0) 
^(DSK07,8) 
= (DSK08,0) 

= (DSK09,0) 
^(DSK09,8) 
: (DSK10,0) 
=(DSX10,8) 
:(DSK11,0) 

=(DSK12,0) 
=(DSK12,8) 
= (DSK13,0) 
=(DSK13, 8) 
=(DSK14,0) 

^(DSK15,0) 
=(DSK15,8) 
=(DSK16,0) 
= (DSK16,8) 
=(DSK17,0) 



TAPE DEVICE GROUPS 



DEVGRP UNIT=34 20 , MODEL=8 , FEATURE=DUALDENS, PATH= (TAP00 , ) , 
ADDRESS=( (0,70), (1,71), ( 2 , 72) , ( 3 ,73 ) ) 

DEVGRP UNIT=24 2 , FEATURE= ( 9-TRACK) , PATH= (TAPO0 , ) , 
ADDRESS=( (8,78) , (9,79) , (A,7A) , (B r 7B) ) 

DEVGRP UNIT=3420 r MODEL=8 r FEATURE=DUALDENS, PATH= (TAP01 , 0) , 

ADDRESS=( (G,B0) , (1,B1) , (2,B2) , (3,B3) ) 
DEVGRP UNIT=240 2, FEATURE=( 9-TRACK) ,PATH= (TAP01 , 0) , 

ADDRESS=( (8,B8) , (9,B9) , (A,BA) f (B,BB) ) 

DEVGRP UNIT=3420 # MODEL=8 f FEATURE=DUALDENS r PATH=( FAP02,0) , 
ADDRESS=( (0,F0) , (1,F1) , (2,F2) , C3,F3) ) 

DEVGRP UNIT=2402,FEATURE=(9-TRACK) ,PATH= (TAP02 , 0) , 
ADDRESS=( (8,F8) , (9,F9), (A, FA) , (B,FB)) 
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TAPE06 DEVGRP UNIT=34 20,MODEL=8 ,FEATURE=DUALDENS,PATH= (TAP03 , 0> , 

ADDRESS=( (0,130), (1,131), (2,132), (3,133)) 
TAPE07 DEVGRP UNIT=240 2 , FEATURE^ (9-TRACK) ,PATH= (TAP03 , 0) , 

ADDRESS=( (8,138) r (9,139) , (A,13A) , (B,13B)) 
* 
TAPE08 DEVGRP UNIT=3420 ,MODEL=8 ,FEATURE=DUALDENS,PATH= (TAP04 , ) , 

ADDRESS=( (0,170) f (1,171) , (2,172) , (3,173)) 
TAPE09 DEVGRP UNIT=2402, FEATUR£= (9-TRACK) ,PATH= (1AP04 , ) , 

ADDRESS=( (8,178) , (9,179) , (A,17A) , (B,17B) ) 
* 

TAPE10 DEVGRP UNIT=34 20 ,M0DEL=8 ,FEATURE=DDALDENS, PATH= (TAP05 , ) , 
ADDRESS=((0,1B0) , (1,1B1) , (2,1B2) , (3,1B3)) 

TAPE11 DEVGRP UNIT=2402 ,FEATURE= (9-TRACK) , PATH= (TAPOS , 0) , 
ADDRESS=((8,1B8) , (9,1B9) , (A,1BA) , (B,1BB)) 

* 

* UNIT RECORD DEVICE GROUPS 
* 

READEROO DEVGRP UNIT=2540R, IOREQ=YES, FEATURE^ (COLBNRY) , PATfi= (UROO , G) , 

ADDRESS=(0,20C) 
PUNCflOO DEVGRP UNIT=25 40P,IOREQ=YES, FEATURE^ (COLBNRY) , PATH= (UROO , ) , 

ADDRESS=(1,20D) 
PRINTERO DEVGRP UNIT=14 3, MGDEL^Nl ,MAXIO=4 , IOREQ=YES, FEATURE^ (UCS ) , 

PATH^(UROQ,G) ,ADDRESS=(2,20E) 

READER01 DEVGRP UNIT=25 40R , IOREQ=YES, FEATURE- ( COLBNRY) , PATH= ( 0R01 , ) , 

ADDRESS=(0,21C) 
PUNCrtQl 'DEVGRP UNIT=25 4 OP , IOREQ=YES,FEATURE= (COLBNRY) r PATH= (UR01 , 0) , 

ADDRESS=(1,21D) 
PRINTER1 DEVGRP UNIT=1403,MODEL=N1 ,MAXIO=4 ,IOREQ=YES,FEATURE= (UCS) , 

PATB=(UR01,G) f ADDRESS=(2,21E) 

* TERMINAL DEVICE GROUPS 

| TUBEQ1 DEVGRP UNIT=3270 , ABUF=64 , DCM=7 , 1 , PE^ASYNCH , 
PATH=(TUOO,0) , 

ADDRESS=( (0,270) ,(1,271), (2, 2 72), (3, 273), 
(4,274) , (5,27 5) , (6,276) , (7,277)) 
* 

RJEOO DEVGRP UNIT=2780 ,MAXIO=3 ,FEATURE= (DIAL, BSYN) , 
PATB=(TM00,0) ,ADDRESS=(0 r 2A0) 

TERMDIAL DEVGRP UNIT=27 41, ABUF=32 ,DCM=2 , BOLDLY , TYPE=ASYNCH , 

FEATURE=(DSLNftDP r DIAL, AUTOCALL) , PATH= (TMOO , ) , 
ADDRESS=( (2,2A2) , (3,2A3) r (4,2A«i) , (5,2A5) f 
(t>,2At>) , (7,2A7) , (8,2A8) , (9,2A9) , 
(A,2AA), (B,2AB) , (C,2AC) , (F,2AF)> 

* 

TERMTTY DEVGRP UN1T=TTY33 ,ABUF=32 ,DCM=3, riOLD=Y,TYPE=ASYNCH, 
FEATURE=(DSLNADP,D1AL) , PATH= (TMOO , ) , 
ADDRESS=(D, 2AD) 

* 

TERMDED DEVGRP UN1T=27 4 1 , ABUF=32 , DCM=2 , HOLD=Y , TYP£=A3YNCH, 
FEATURE^ (DSLNADP, DEDICATED) r PaTH= (TMOO , ) , 
ADDRESS=(L, 2AE) 

* 

LDR3704 DEVGRP UNIT=3704 ,MAXIO=3 , IOREQ=YES r PATH= (TRMIPL, ) , 
ADDRESS=(0,2B2) 

| OPCNSL (240, ALARM) , (260, ALARM) , 

| (209,ALARM,HRDCOPY) , ( 21h , ALARM, BRDCOPY ) 

* TASK MANAGEMENT AND COMMAND SYSTEM 



* 
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TSKLMT CONV=20 ,BaTCH=100 ,BACK=bO ,MTTADM=1 0, RTAMBUF=8 , 

PGTBL=32 ,PSLMT=256 
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DISPAR LCT=(l f 10) f LDMTR=2, AUXSP==(250 f 500) ,BLKSZE=(12, 12) 

VMPAR VCSLNG=20, SDST=25 ,OPTIONS= (PUBSEG, PACKSEG) , 
TIME=07000000 

CLOP TATYPE=9D3 ,DATYPE-333B, DEN=3 , DAPAGES= ( 38 , 62 ) , FIR=Y, 
DACYLS= ( 3 , 5 ) , DATRKS=2 , LIBPGS= ( 2 , 1 ) , CFM=CARDS , 
PRIO=8 , PFM= PAPER , DSORG=VS t MAV=512 , AUTH=U # 
PRVLG=(D # B f E f C f S # T,U) # PRMTLMT=4 f LABTYP=NL 

PUBVOL MAXVOL=20 

GENSCB 
END 
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APPENDIX F: 



RULES FOR ASSIGNING SYMBOLIC DEVICE ADDRESS NOTATIONS 



A symbolic device address, designated oy as many as three hexadecimal 
digits, uniquely identifies a device although the device may have sever- 
al hardware addresses. Symbolic device addresses should De arranged as 
if in table format. 

1. Addresses of paging devices snould be at the beginning of the ta- 
ble; drum storage units must precede disk storage units. Tnus, the 
first paging drum would have an address of 1. 

| 2. Each 2305 drum has eight addresses reserved tor it. Only trie first 
| is assigned by tne system programmer; tne others are reserved by 
the system. Therefore , if an address on N is assigned to a 2305 
drum, the system also reserves the addresses N+l to N+7 for it. 

3. After addresses have neen assigned to all drum storage units, tne 
next five addresses are reserved by the system for its own use. 
Thus, if the address N were assigned by an installation to the last 
2305 drum, an address of N+D is the next available address. 

4 . Addresses are next assigned to disk storage units for paging and to 
system residence devices. Subsequent addresses are assigned to 
other devices; those devices that are apt to be used most frequent- 
ly should have the lowest symbolic addresses. 

5. Unused groups of addresses increase the size of several resident 
supervisor tables. While these gaps are useful for assigning ad- 
dresses to new devices, they should be used with care. 

The symbolic device addresses CSDAs) assigned to the devices In the 
machine configuration of Appendix D are shown in Table 1; corresponding 
physical device addresses (PDAs) are also shown. The first digit of the 
PDA is the cpu address, the second digit is the channel address, and the 
third and fourth digits are the control unit-device address. 



Table 1. Symbolic Device Address Assignment in a Starter System 



SDA 



I 



PDA 



|_- 



1 

9 
11 

19 

40-43 

48-4B 

50-53 

58-5B 
60-63 



01C0 
01D0 
O2C0 

f 

02D0 

0150- 

0158- 

0160- 
0168- 
0170- 



h 



70-73 
78-7B 
80-83 

88-8B 
90-93 
98-9B 



r llC0 
r llD0 

,12C0 



,12D0 
53,1150- 

5B,1158- 

63,1160- 
6B,1168- 
73,1170™ 






'53 
SB 

f 

63 
6B 
73 



0180- 
0188- 
0250- 

+_ . 

0258- 
0260- 
0268- 



83,1180- 
•8B,1188- 

'53,1250- 

5B,1258~ 
63,1260- 
6B,1268- 



83 

8B 
53 

f 

5B 
63 
6B 



DEVICE 1 

— — H 

2305-2 
2305-2 
2305-2 

2305-2 
3330-1 
3330-11 

3330-1 

3330-11 

3350 

— — - i 
3420 
2402 
3330-1 

3330-11 

3330-1 

3330-11 
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Table 1 — continued 



A0-A3 

B0-B3 

B8-BB 



0270- 
0280- 

28 8- 



73,1270-73 
83,1280-83 
8B,1288-8B 



3350 
3420 
2402 



C0-C3 
C8-CB 
D0-D3 



0350- 
0358- 
0360- 



-53,1350-53 
•5B,1358-5B 
-63,1360-63 



3330-1 

3330-11 

3330-1 



08-DB 
E0-E3 
F0-F3 



0368- 
0370- 
0380- 



6B,1368-6B 
73,1370-73 
83,1380-83 



3330-11 

3350 

3420 



F8-FB 

100-103 
108-10B 



0388-8B,1380-8B 
0450-53,1450-53 
0458-5B,1458-5B 



2402 

3330-1 

3330-11 



110-113 
118 -11B 
120-123 



0460-63,1460-63 
0468-6B,1468-6B 
0470-73,1470-73 



3330-1 

3330-11 

3350 



130-133 
138-13B 
140-143 



0480-83,1480-83 
0488-8B,1488-8B 
0550-53,1550-53 



3420 
2402 
3330-1 



148-14B 
150-153 
158-15B 



0558-5B,1558-5B 
0560-63,1560-63 
0568-6B,1568-6B 



3330-11 

3330-1 

3330-U 



160-163 
170-173 
17 8 -17 B 



0570- 
0580- 
588- 



73,1570-73 

83,1580-83 
8B,1588-8B 



3350 
3420 
2402 



180-183 

188-18B 
190-193 



0650- 
0658- 
0660- 



53,1650-53 
5B,1658-5B 
63,1660-63 



3330-1 

3330-11 

3330-1 



198-19B 
1A0-1A3 
1B0-1B3 



0668- 
0670- 

0680- 



6B,1668-6B 
73,1670-73 
83,1680-83 



3330-11 

3350 

3420 



IB 8- IBB 
209 
20C 



0688- 
0009 

oooc 



8B,1688-8B 
,1009 
,100C 



2402 

1050-7 

2540R 



20D 
20E 
21C 



000D, 

000E 

001C 



H~ 



,100D 
,100E 
,101C 



2540P 

1403 

2540R 



21D 
21E 
21F 



001D 
001E 
001F 



,101D 
,101E 
,101F 



2540P 

1403 

1050-7 



240 
260 
270-277 



0040 ,1040 
0060 ,1060 
0000-07,1000-07 



Y" 



3066 
3066 

3270 



2A0 
2A2-2AC 
2AD 



OOAO ,10A0 
00A2-AC,10A2-AC 
00 AD ,10AD 



2780 
2741 

TTY33 



2AE 
2B2 



OOAE 
00B2 



,10AE 
,10B2 



X- 



2741 
3704 
x 
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APPENDIX 6: PROCEDURE FOR MAKING TSS OPERATIONAL 



The TSS starter system can run with the minimum TSS hardware configu- 
ration, and is delivered as two file- protected, unlabeled 9-track, 1600 
bpi magnetic tape reels. The first tape contains the stand-alone inde- 
pendent utilities. The second tape is a disk restore for TSSRES (the 
first public volume). 

1. Tape Contents 

a. The utility programs (except core dump) may be loaded directly 
from the independent utility tape. Table 2 shows the order of 
the four utilities on the tape. 

Table 2. Independent utility order 

r 1 — ri 

| Program | Module ID | 

I r H 



1 


DASDI 


1 


CEBDZ 


1 


1 


DUMP/RESTORE 


1 


CEBDR 


1 


1 


VAM2OT 


1 


CEBVP 


1 


1 


Core Dump 


1 


CEBCP 


1 


L_. 




-L 




-J 



b. The contents of the disk volume TSSRES after being restored is 
described in Appendix B. 

2. Initialize disks from independent utility tape 

a. Mount the independent utility tape, or the tape reel copied 
from the original tape, on any available 9-track, 1600 bpi tape 
drive and set the address of this drive in the LOAD unit 
switches on the operator's console. Mount two disk packs, 3330 
or larger, on available disk drives. 

b. Be certain that the load-unit switches contain the three-digit 
address of the utility tape mounted in accordance with 2a, 
above. Press the STOP key and then the LOAD key. The LOAD 
light will come on, and TSS DASDI will be loaded from the tape. 
When the load procedure is complete, the WAIT light will come 
on. 

c. Press the REQUEST key on the console keyboard; this message 
will be typed out: 

CEB105A DEFINE INPUT DEVICE. DASDI X. X 

(x.x indicates the release level of the TSS associated with 
this version of DASDI). 

The operator enters the response in either upper- or lower-case 
characters: 

input=xxxx cuu EOB 

where xxxx is the type of the device in which the DASDI control 
cartfs have been placed (2540), and cuu is the physical hexade- 
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cimal address of that device — c is the channel and uu is the 
unit (00E, 061), EOB is the end-of-block character. 

The DASDI control cards are specified in Independent Utili- 
ties , These control cards enable the installation to initia- 
lize or "DASDI" the two disk packs necessary for a minimum con- 
figuration. DASDI is also used to initialize other public 
volumes, define paging space on new public volumes (other than 
TSSRES), and to initialize private disk volumes. The charac- 
teristics of the two packs needed for the minimum configuration 
are shown in Table 3. 



Table 3- Disk pack characteristics 

t , , i ■ -,-. — rr — ir 1 — — t : ~ 1 

| TODEV J FORMTYPE | VOLTYPE | NEWVCLID | 

I K __*_ 4 — __ , 

[3330 or larger | VAM2 | PUBLIC | TSSRES j 

I I I I I 

j 3330 or larger | VAM2 | PAGING | PAGING | 

t— — x_^ x; 1 ; i , j 

d. When DASDI is complete, the message END OF JOB is printed on 
the message device (1052 or 1403). If control cards for all 
devices to be initialized have been loaded, DASDI will continue 
with the next device in a stacked- job environment with no fur- 
ther intervention. 

e. In addition to the minimum number of disk packs to be initia- 
lized, the 2301 and 2305 drums in the installation's total sys- 
tem configuration must also be initialized via DASDI. (See the 
Independent Utilities manual. ) 

Restoring TSSRES tape to disk 

a. When all disk packs and drums have been initialized via DASDI, 
place control cards for dump/restore in the card reader (2540) 
and IPL the independent utility tape once again without rewind- 
ing . The system returns the message: 

CEB105A DEFINE INPUT DEVICE TSS DUMP/RESTORE x.x 

when the request key is pressed. This second IPL will bring in 
the dump/restore program. The keyword parameters TODEV=xxxx 
and TOADDR=cuu on the control cards (see below) should reflect 
the device and physical address of the disk pack that will be 
the TSSRES public volume (See the Independent Utilities 
manual). 

Startup basic system 

The following is the operating procedure for starting up a basic 
TSS system. See Section 2 for notes concerning the minimum 

configuration. 

a. Load PRELUDE from TSSRES volume by setting load selector 
switches and pressing console LOAD key; PRELUDE locates and 
reads the Independent Access Method module; the wait state is 

entered. 

b. Define the main operator's terminal by pressing the REQUEST 
key. The following is an example of system prompting messages 
and operator responses that take place during a TSS Startup: 
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SYSTEM : 
OPERATOR : 

SYSTEM : 
OPERATOR: 



? 

Is 



(This indicates that a TSS long start is desired) 



SYSTEM : 
OPERATOR : 

SYSTEM : 
OPERATOR : 

SYSTEM : 

OPERATOR : 

SYSTEM : 

OPERATOR: 



SYSTEM: 
OPERATOR : 

SYSTEM : 
OPERATOR : 

SYSTEM : 

OPERATOR : 

SYSTEM : 
OPERATOR : 

SYSTEM: 

OPERATOR: 

SYSTEM : 
OPERATOR : 

SYSTEM : 
OPERATOR : 

SYSTEM: 



ENTER PJIY ADDRESS OF CARD RDR OR DEFAULT = ECB. 

(presses EOB) 

(If the address of a card reader 
had been entered, the following 
operator responses would have 
be&h read from cards) 

ENTER AfcOfc. OF PAGING DISK 
204 



PRINT MAPS? 12 3 
3 



NONE IVM RESSUP BOTH 



OPERATOR: 



SYSTEM: 



ENTER CODE FOR FUNCTIONS NOT TO BE LOADED 

ALL FUNCTIONS WANTED « EOB 

99 (The system performance monitor is not to be loaded) 

QUICK START REQUESTED? IF Y ENTER ADDR OF PACK 
FOR QUICK START DATA SET i N*EOB 

201 (Assuming TSSRES pack on 201 

and Quickstart data set is 

to be created. ) 

DELTA DATA SETS? Y OR N 

n 

CURRENT CLOCK VALUE IS 05/14/36 07. 23.11 IS CLOCK CORRECT? 
n 

ENTER DATE AND TIME AS 
MM/DD/YY HH.MM.SS 
11/17/76 10.04.00 

DEPRESS TOD SWITCH 

(Presses the time of day clock enable switch) 

CURRENT CLOCK VALUE IS 11/17/76 10.04.01 IS CLOCK CORRECT? 

y 

$ (Enters the Resident Support System) 

run (RSS exits to TSS) 

BUIKCO REQUIRED? 
Y 

Y ACCEPTED 
10:06:49 SYSCPER0 CZAFM LOGON AT 10:06 TASKID=0001 

SDA=0078 
10:06:49 TSS00001 BATCH MONITOR HAS BEEN INITIALIZED 

10:06:49 R=0001 SYSOPER0 VALIDATE THE SYSTEM HARDWARE 

CONFIGURATION. REPLY OK WHEN DONE 
(Presses REQUEST) 
reply l,ok 

STARTUP COMPLETE, USERS MAY LOG ON 

10:07:12 SYSCPER0 CZAFM LOGON AT 10:07 TASKID=0002 

10:07:31 SYSOPER0 *CZAWS* ASNBD f S DONE: A010-01 A011-02 



5. Assemble system generation macro instructions 

Wien STARTUP is complete, a system programmer may log on (userid 
TSS, password IBM). The system generation source statements for 
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the first system generation are typed from a terminal or read from 
a card reader. This section shows the script necessary to generate 
a systcsm. The dsname of the data set (defined as a J0BLIB) that 
will contain the system generation module is SYSGEN . MODULE . 

SYSTEM 

PR0GRAI4MER : (presses REQUEST key) 

logon tss f ibm 

SYSTEM :; TASKID=0OE*i LOGON AT 10:08 ON 11/15/76 

SYS . PRQGR « : ddef ddl f vp f dsnarae=sysgen. module, option=jobiib 

ddef macl,vi,dsname s asiumac(0) 

ddef ndxl,vs, dsname =asinndx ( > 

ddef mac2,vi,dsname=genmac(0) 

ddef ndx2,vs,dsname=genndx(0) 

asm sysgen,n, (macl,ndxl,mac2,ndx2) , , n,n,y,y ,n,n,y 

SYSTEM: 100 



System programmer enters system generation 
macro instructions; refer to Appendix E 

for example 



If the assembly is error- free , the system prompts with an unde- 
rscore. Otherwise , the system asks the system programmer to enter 
modifications, 

SYS . PRQGR , : print list. sysg en ( 0) , , , edit, erase 

SYSTEM ; PRINT BSN026** 

SYS. PRQGR. : logoff 

SYSTEM S LOGOFF AT 10:32 ON 11/17/76 

TERMINAL LOGICALLY DISCONNECTED, RECONNECT OR 

HANG UP. 

If this procedure is to be repeated without modifications, before 
attempting to reassemble the SYSGEN macro instructions the system 
programmer must explicitly erase the SOURCE . SYSGEN data set and the 
SYSGEN. MODULE data set. 

6. Execute the APGEN procedure 

When the system programmer has determined the accuracy and com- 
pleteness of assembly , he executes the APGEN script to generate a 

TSS that is adapted to his installation. 

Note : APGEN takes the output of the SYSGEN assembly and updates 

system modules and tables residing on the TSSRES volume. (Assume 
system programmer has logged on. ) 

SYS . PRQGR . s execute apgen 

SYSTEM : BSN=0265 

SYS. PRQGR. : logoff 

SYSTEM: LOGOFF AT 10:59 ON 11/17/76 

TERMINAL LOGICALLY DISCONNECTED, RECONNECT OR 

HANG UP, 

At this time, the SYSGEN. MODULE data set can be erased if the pro- 
cedure to assemble the SYSGEN macro instructions is to be repeated. 
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The following warnings should be kept in raind. 

a. The APGEN procedure updates the TSSRES volume in place; 
whenever APGEN is run, the TSSRES volume used will contain the 
new system. Be sure to make save tapes of any systems which 
should be kept. Only the TSSRES volume is affected during 
APGEN . 

b. The data set names o.sed during the first log-on must be the 
same as those in APGEN, This can be assured by following the 
script exactly, except for user password and charge number. 

c. During the first STARTUP, there must be no public VAM2 disk 
(other than the TSSRES) on the system. If there is such a 
public VAM2 disk, one of the system queues will appear on it 
and that disk will always be required as part of the system. 
Furthermore, no housekeeping routines may be run against that 
disk since the erasure of that queue will make the system 
inoperable, 

d. System generation data sets should be referred to by relative 
notation. When versions of TSS are released, the absolute 

generation numbers may be changed dynamically during the 
updating process. 

e. Messages, like the following, received during APGEN may be 
ignored: 

W***THE STANDARD ENTRY POINT OF INPUT MODULE SYSGEN CAN- 
NOT BE SAVED hS AN AUXILIARY ENTRY POINT. 

W***THE FOLLOWING EXTERNAL REFERENCES ARE UNRESOLVED: 
CEHAPA, CEiIASA, CEHAEA, CEHADA, CEHACA, CEHAQA, CEAKTS, 
CEAB81, CEAE91, CEAAUO, CEAIAA, CEANBA, CEAA31 , CEAHQP, 

CEANAA , CBBECXRB , CHBECXRC 



Messages, like the following, printed on the Startup memory 
in ap m ay be i g no r ed ; 

CSECT CIPIOl MISSING OR POD FORMAT ERROR. 



The assembler work space must be expanded if exceptionally 
large asseroolxes are to be run. The following patches will 
expand the work spaces: 

SET CEVW1. ( r 4)=X , 00000180 - 
SET CEVW2. ( r u)--X , 00000180' 
SET CEVW3, C , 4)=X , 0000005C 

'Ihese patches n*ay be entered through PCS by properly author- 
ized users and should not be permanently applied to your sys- 
tem, since they will cause unnecessary paging for small 
assemblies . 



If the system crashes, ail current accounting inf cr mat ion for 
the active users ivill be lost. This information will not be 

written out. after the crash. The user may run UPDTUSER to 
r e c o v e, r p e rut a n e n t s t. o rage accounting. 
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After executing the APGEN script and logging off, the system pro- 
grammer has initialized a software system tailored to the installa- 
tion's hardware system • Recommended: shut down the system and 
make a save tape of the new TSSRES volume. When the operator IPLs 
from the new TSSRES volume, PRELUDE reads in STARTUP. After 
STARTUP is completed, the system manager can log on to join other 
users to the system; TSS is ready for use. 

7. After the APGEN script logs off, the software system is tailored to 
the installations hardware system. APGEN has updated the TSSRES 
in place? and completed the system generation process. The system 
should now be shut down and, using the DUMP/RESTORE program, a dump 

should be made to tape of the new TSSRES. 

CAUTION;, Saving the TSSRES volume should facilitate recovery from 

system or hardware problems that may occur in the next step. 

8. After the startup is complete, TSS is ready for use. After all 
users are joined, it is advisable to shut down the system and make 

a dump of the TSSRES volume to tape* 

9. With the starter system complete, the public volumes may now be 
added* If there are old public volumes as the result of a previous 
TSS release, the volumes can now be introduced, the system started 
up again, and the catalog reconstructed using the CVV command, or 
the pub Lie volumes reconstructed and cataloged using the RPS com- 
mand. The TSSRES volume and all public volumes should then be 
saved. 

10, if new pubic volumes were added, or old public volumes introduced, 

that contain paging bands, the dedicated paging pack may be 
removed . 
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APPENDIX H: SAMPLE MAINTENANCE PROCEDURES 



This sample maintenance procedure is for a system that has changes 

fci: several, system data sets. In the first example, the maintenance re- 
l^df> tape contains no change for any of the system generation macro in- 
structions (that requires a SYSGEU assembly), or any utility macro in- 
structions, or for prelude, and contains tne following files: 

1 Replacement source modules 

2 TAPE. SCRIPT 

3 TAPE.ASMMAC 

4 TAPE.ASMNDX 
D TAPE.5YSMAC 
b TAPE.MACNDX 

7 TAPE.GENMAC 

8 T2PE.GENNDX 

9 TAPE.SYSIAto 

10 TAPE, STARTUP 

11 TAPE. SYSUTL 

12 TAPE.SYSIVfc 

13 TAPE.RESSUP 

14 TAPE.RSSSUF 
lb TAPE.SYSLIB 

16 TAPE. SYSERP 

17 TAPE. UPDATE. ASMMAC 

18 TAPE. UPDATE. SYSMAC 

19 TAPE* UPDATE. GENMAC 

20 TAPE.APGEN 

21 TAPE. UPDATES 

After starting up your current operational system, it is advisable to 
restrict the system s s use to user id TSS during the update session. Af- 
ter the session is complete, you should shut down and save all your sys- 
tem volumes. (See Figure 9 for the conversational session.) 



r~ 



LOGON TSS, password *Logon system programmer* 

DDEF DDTV,PS ff TAPE. SCRIPT r (DEN=3) , (TA f 9D3), f ( f VAMTAP> f C2,ML) , OLD 

* Define and have the 16 00 bpi 
change tape mounted* 

TV TAPE. SCRIPT, SCRIPT* UPDATE 

♦Tape to VAM copy of the script data set* 

RELEASE DDTV * Release VAMTAP for the execute* 

EXECUTE SCRIPT. UPDATE *Start the update task* 

LOGOFF *And LOGOFF the conversational task* 

,M9^, : Allow the execute task to run to completion and examine SYS- 
OUT before shutting down and saving your new system, 

i- ---—--_--_-__--___--__-__________-_____-___ — _„„„_„_ .. . j 

Figure 9. Conversational Update Task 

For the purposes of the second example, the maintenance release tape 
contains changes to the SYSGEN macro instructions that make a new SYSGEN 
assembly necessary- (See Figure 10 for the conversational session.) 
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LOGON TSS password * Logon system programmer* 

DDEF EDTV, PS, TAPE- SCRIPT, <DEN=3), ( TA , 9D 3 ) , , ( ,VAMTAP), (2,NL) , CLD 

♦Define and have the 1600 fcpi 
change tape mounted* 



TV TAPE. SCRIPT, SCRIPT. UPDATE 

PRINT SCRIPT. UPDATE 

EDIT SCRIPT. UPDATE2 
0000100 LOGON TSS 



♦Tape to VAM copy of the script to 

public storage* 
♦ Print a copy for edit purposes* 

♦Start a second script 
for parts three and four* 



0000200 EXCERPT SCRIPT. UPDATE ,N1=15300 r N2=LAST 



_END 

EDIT SCRIPT. UPDATE 
0019500_EXCISE 15300, LAST 
_INSERT 15200 r 100 
0015300 LOGOFF 

___END 

PRINT SCRIPT. UPDATE 

PRINT SCRIPT. UP DAT2 

EXECUTE SCRIPT. UPDATE 



♦Excerpt parts three and four of the 

second scrip t* 
♦The second script is complete* 

♦Remove parts three and four 
from SCRIPT. UPDATE* 

♦SCRIPT. UPDATE is now parts one and 

two* 



♦Revised 

♦Excerpted 

♦This will complete parts one and two 
and setup for the update* 



Note: Wait for this nonconversational task to complete and examine 

SYSOUT before continuing. 
DDEF SRC1,VI,NEW. SYSMAC ,DISP=OLD 

DDEF NDXl,VS,NEW.MACNDX,DISP=OLD ♦Now your DDEFs 
DDEF SRC2,VI,NEW,ASMMAC,DISP=OLD will set up the new 

DDEF NDX2,VS,NEW.ASMNDX,DISP=OLD SYSGEN macros* 

DDEF SRC3,VI,NEW„GENMAC,DISP=OLD 
DDEF NDX3,VS,NEW.GENNDX,DISP=OLD 

DDEF LIB, VP, SYSGEN. MODULE, OPTION=JOBLIB ,DISP=NEW 
ASK SYSGEN, Y, (SRC1,NDX1, SRC2 ,NDX2,SRC3,NDX3 ) 
RELEASE LIE 
EXECUTE NEW.APGEN *This new APGEN was included in part 

one* 
Note. Wait for APGEN to complete and log off 



RELEASE SRC1 

RELEASE NDX1 

RELEASE SRC 2 

RELEASE NDX2 

RELEASE SRC 3 

RELEASE NDX3 

EXECUTE SCRIPT. UP DATE 2 

LOGOFF 



♦ Release iracrc libraries for 

execute* 



♦Now you can complete the update ♦ 
♦Conversational task complete* 



Note : When the last task ( SCRIPT. UPDATE2 ) logs off, and you have 

examined SYSOUT your new system is complete and you can shut- 
down and save it. 



Figure 10. Update and Assemble SYSGEN Macro Instructions 
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APPENDIX I: SAMPLE DYNAMIC MODIFICATION PROCEDURES 



1. Load PRELUDE from the IPL volume. When the independent access 
method module has been read in, the system enters the wait state. 

2. Press the REQUEST key to define the main operator's terminal. 

3. The STARTUP process proceeds as shown in Appendix G, under 4, until 
the request for dynamic modifications is to be answered. 

SYSTEM : DELTA DATA SETS? Y OR N. 

OPERATOR : y 

4. To dynamically modify the system with a private volume, having 
hardware address 207 and containing data sets in the following 
order, the operator may specify one of various searches. 

Order on volume: 

USERID1* . IVM01. XX 
USERID2*.IVM01.YY 
USERID3*. IVM02. XX 
USERIDl*. SUP02. Z 
USERIDl*. SUP02.Y 
USERID1*.IVM03.AA 
USERIDl*. IVMO 4 
USERID2*.SUP03.BB.C 
USERID3*.RSS01.W 

These are the searches that result, for the various responses to: 

SYSTEM : ENTER DEVICE ADDRESS AND DATA SET SPECIFICATIONS. 

OPERATOR : 0207,useridl* 

Resulting search: 

USERIDl*., IVM01. XX TSS*****. RSSSUP USERIDl* . SUP02 . Z 

USERIDl*. IVM03.AA USERIDl* . SUP02 .Y 

USERIDl*. IVM0*l TSS*****.RESSUP 

TSS*****»SYSIVM 

OPERATOR : 0207 ,us erid2 *. ivmOl ,user id3* 

Resulting search: 

USERID2*. IVMOl. YY USERID3*. RSS01. W TSS ***** m RESSUP 

USERID3*.IVM0 2.XX TSS*****. RSSSUP 

TSS*****. SYSIVM 

OPERATOR : 0207 r us eridl *. sup02.y , user idl* . sup02. z 

Resulting search: 

TSS*****. SYSIVM TSS*****. RSSSUP USERIDl* . SUP02 . Y 

USERIDl*. SUP02.Z 
TSS*****.RESSUP 

5. The STARTUP process continues as in Appendix G f under 4. 



62 



PageofGC28-2010-7 
Added February 11, 1978 
By TNI. GN20-38O9 



APPENDIX Js STRING SWITCH SYSGEN EXAMPLES 



-:> clarify tue SYliGEM macros necessary to generate the pathfinding 

;.•< :'ot: ;^ti1ng sw,I*.ah:>c! *u calces, two examples are given in this 
*ir? • x ♦ 

'.iv*-n-t^'i' ]. r j<./i..jr.^'cvic string switched devices -~ two channels, two 
*oY 'luits, and three device groups — ~ is as follows: 



1 


f 
I 

i 


! 1 
S I 

:?WAMl S ! CNAM2 I 

24 X j j 3 6/ | 






! 
; 


j ', i v, f 


.. -' - ri » 


i r-- : - '-'-■ i ; 


• '',)**' »■).. ? 




i ;-■■ \ : 


i 

i 

i 




i - ''■■'■» j i 1 

i <-- -! i 

1 * i •: 

i j i... 10 j jADDHES3ES=024G,036G 

t ■■ - -i 1 

i '- -•' 1 

1 

*"•- * f-~ " J 

i i 

i MM : 
i M '•- —i i 

1 ; ^*m? i i 


i err,- , 

; i. nt ".,«•■ i ■ 

i 


^.-, 


i 




1 • - H ; 






! i -- • 1 : 

i i t * 



I 



V; r'} I .ADDRESSES=0250 r 03?G 
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CNAM1 DCU UNIT=3830 r MODEL=2,PATH=(0240-5F) 
CNAM2 DCU UNIT=3830 f MODEL=2,PATH=(0360-7F) 

DNAM1 DEVGRP UNIT=3330,PATH= C (CNAMl , 0) , (CNAM2, > ) , 

ADDRESS=((0,16) ,(1,17)) 
DNAM2 DEVGRP UNIT=3330,PATH= ( (CNAM1, 8> , (CNAM2 , 8> ) , 

ADDRESS=((0,18) ,(1,19)) 
DNAM3 DEVGRP UNIT=3350, PATH= ( (CNAM1,10) , (CNAM2 , 10) ) , 

ADDRESS= ( C , 1A) , (1 , IB) , i 2 , 1C) ) 

Example 2: complex (32 drive addressing) string switched devices 
six channels, three control units, and six device groups — is as 

follows: 



CHANNELS; 1 



I 



CNAMl | 
., 

3830 | 
(X2X) J 



CNAM2 



3830 
CX4X) 



,._J.- 



| CNAM3 

| 3830 
1 CX6X) 

L r 



1 



J 



l_ „ 



TAG=00 | 1 TAG=0 TAG=18 | 
r X„X. ^ .. X_ 



DNAM1 



3333 

-T~T- 



I 



| TAG=10 
-X „ 



DNAM5 

3333 
_ T — T — 



11 II 

TAG=08 | I TAG=0 8 TAG=10 | | TAG=18 
-X — X , .. X„X_ 



DNAM2 
3333 



I 



DNAM6 
3333 



1 r 

TAG=10 | | TAG=00 

r X X, 

I DNAM3 | 

H- — -H 

I 3333 I 



TAG=18 [ 



| TAG=0 8 



r ^ -^ 

| DNAM4 1 

i- ^ 

| 3333 | 

L . J 



Device groups have the following base addresses: 

DNAM1 0120,0220,0340,0440 
DNAJM2 0128,0228,0348,0448 
DNAM3 0130, 0230, 0560, 0b60 
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DNAM4 0138,0238,0568,0668 
DNAM5 0358,0*158,0570,0670 
DNAM6 0350,0450,0578,0678 

Note that: the string switch tags are not symmetrical arid contribute bits 

3 and 4 of the device address. Three DCU statements and six DEVGRP sta- 
tements will be required. The 3330 devices have been omitted for 
clarity, 

CNAM1 DCU UNIT=3830 r MODEL=2,PATH-(0120-3B\0220-"jjr' ) 
CNAM2 DCU UNIT=3830,MODEL=2,PATH=(03a0-5F (f 0UU0-!>f) 
CNAM3 DCU UNIT=3830,MODEL==2,PATH=(0560-7F,066G--7i-) 

DNAM1 DEVGRP UNIT=3330,PATH= ( (CNAM. ,0) r (CNAM2 , 0) ) , 

ADDRESS=((0,10) , (1,11) ,.. . ) 
DNAM2 DEVGRP UNIT=3330,PATH= ( (CNAM1 ,8) , (CNAM2 , 8) ) , 

ADDRESS=((0,18) , (1,19) , ,. . ) 
DNAM3 DEVGRP UNIT=3330, PATH= ( (CNAM1, 1 0) , (CNAM3 ,0) ) „ 

ADDRESS=((0,20) , (1,21) , • . . ) 
DNAM4 DEVGRP 13NIT=3330,PATH= ( (CNAM1 , 18) , (CNAW3 , 8) ) , 

ADDKESS=((0,28) , (1,29) ,. . . ) 
DNAM5 DEVGRP UNIT=3330 r PATri= ( (CNAM2, 18) , (CNAM3 ,10) ) , 

ADDRESS=((0,30) , (1,31) ,... ) 
0NAM6 DEVGRP UN1T=3330,PATH= ( (CNAM2 , 10) , (CNAM3 , 1 ~8) ) ,' 

ADDRESS=( (0,38) , (1,39) ,. . . ) 
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